mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-11-17 03:39:33 +01:00
feat(local-model): contract for the install stage (types, stubs, fake runtime)
The types, the module skeletons and the test fake that let the runtime, the install job and the window be built at the same time. Types: - src/types/local-model-install.ts (new): the runtime pin, the install states, steps and error codes with one sentence and one next step each, the progress, the `install` object of GET /api/local-model, the bodies and 409 answers of the install verbs, the state file. `LocalModelStatus` moves here; `install` is optional until the route emits it. - src/types/local-model.ts: the catalogue row's Mac memory figures, the measured speed of a tested entry, the `measured` budget source, `RecommendOptions`, and the row tag, the coding agents and the install total of a candidate. All optional until the catalogue and `recommend()` carry them, so the read-only stage keeps compiling and its tests stay green. Modules with final signatures and bodies that throw: runtime.ts (the compiled pin is final), ollama-client.ts, developer-tools.ts, state-store.ts, install-job.ts (the state, step and transition tables are final), connect.ts, custom-model-hosts-writer.ts, cli-install-runner.ts. Nothing imports them yet, so the server is unchanged. Implemented: paths.ts (every folder of the feature, from dataPath()), and `modelFitsBudget()` in recommend.ts, the judgement the job makes with the measured budget before it downloads a model. `recommend()` takes the options parameter and does not read it yet. Test fake: test/fixtures/fake-ollama.ts, a runtime on a port the system picks, in the shapes measured on a Mac: version, tags, ps, the pull stream (MLX and GGUF lines, an error line, a cut stream, a resumed pull), chat with and without a tool call, the model list, a runtime archive with Range support, and a fake child process that logs the device total. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
1 parent
66ca92f7cf
commit
771072c36b
17 files changed
+3770
-23
No files matched your search
@@ -0,0 +1,87 @@
|
||||
/**
|
||||
* @fileoverview Where everything of the local model lives on disk. One pure function, so the
|
||||
* runtime, the install job and uninstall all name the same folders.
|
||||
*
|
||||
* Layout, all under the data dir (`dataPath()`, so a second Codeman instance has its own):
|
||||
*
|
||||
* ```
|
||||
* local-model.json the state file (mode 0600)
|
||||
* local-model/
|
||||
* runtime/ollama-<version>.tgz.partial the runtime archive while it downloads
|
||||
* runtime/ollama-<version>.unpack/ where the archive is unpacked, before the rename
|
||||
* runtime/ollama-<version>/ the unpacked runtime; its binary is `ollama`
|
||||
* models/ the runtime's model store
|
||||
* home/ the runtime's private HOME (its key pair lands here)
|
||||
* ```
|
||||
*
|
||||
* Rules:
|
||||
* - `root` is the ONE folder this feature owns. Nothing is written or deleted outside it,
|
||||
* except the state file beside it and the two writes of the connect step (the endpoint
|
||||
* record and the settings flag), which have their own writers.
|
||||
* - Every path comes from here. None is ever read back from the state file, so a state file
|
||||
* cannot point a delete anywhere else. `isInsideLocalModelRoot()` is the check a delete
|
||||
* makes before it runs.
|
||||
* - Pure apart from `dataPath()`, which resolves (and creates) the data dir.
|
||||
*/
|
||||
|
||||
import { join, resolve, sep } from 'node:path';
|
||||
import { dataPath } from '../config/instance.js';
|
||||
|
||||
/** A runtime version as it may appear in a folder name: digits and dots only ('0.40.15'). */
|
||||
const VERSION_PATTERN = /^\d+(?:\.\d+){1,3}$/;
|
||||
|
||||
export interface LocalModelPaths {
|
||||
/** `<data dir>/local-model`: the one folder this feature owns. */
|
||||
root: string;
|
||||
/** `<root>/runtime`: the archive and every unpacked version. */
|
||||
runtimeRoot: string;
|
||||
/** `<root>/runtime/ollama-<version>`: the unpacked runtime. */
|
||||
runtimeDir: string;
|
||||
/** The runtime's binary: `<runtimeDir>/ollama`. */
|
||||
binary: string;
|
||||
/** `<root>/runtime/ollama-<version>.tgz.partial`: the archive while it downloads. */
|
||||
archivePartial: string;
|
||||
/** `<root>/runtime/ollama-<version>.unpack`: the temporary folder the archive is unpacked into. */
|
||||
unpackDir: string;
|
||||
/** `<root>/models`: the runtime's model store. */
|
||||
modelsDir: string;
|
||||
/** `<root>/home`: the runtime's private HOME. */
|
||||
homeDir: string;
|
||||
/** `<data dir>/local-model.json`: the state file. */
|
||||
stateFile: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* The paths of the local model for one runtime version. Throws on a version that is not
|
||||
* digits and dots, so a version string can never add a path segment.
|
||||
*/
|
||||
export function localModelPaths(version: string): LocalModelPaths {
|
||||
if (!VERSION_PATTERN.test(version)) {
|
||||
throw new Error(`Not a runtime version: ${JSON.stringify(version)}`);
|
||||
}
|
||||
const root = dataPath('local-model');
|
||||
const runtimeRoot = join(root, 'runtime');
|
||||
const runtimeDir = join(runtimeRoot, `ollama-${version}`);
|
||||
return {
|
||||
root,
|
||||
runtimeRoot,
|
||||
runtimeDir,
|
||||
binary: join(runtimeDir, 'ollama'),
|
||||
archivePartial: join(runtimeRoot, `ollama-${version}.tgz.partial`),
|
||||
unpackDir: join(runtimeRoot, `ollama-${version}.unpack`),
|
||||
modelsDir: join(root, 'models'),
|
||||
homeDir: join(root, 'home'),
|
||||
stateFile: dataPath('local-model.json'),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Whether `path` is the local model folder itself or lies inside it, judged on the resolved
|
||||
* text (no filesystem access, so a symlink is not followed: a caller that deletes checks the
|
||||
* real path first). `..` segments are resolved before the comparison.
|
||||
*/
|
||||
export function isInsideLocalModelRoot(path: string, root: string = dataPath('local-model')): boolean {
|
||||
const base = resolve(root);
|
||||
const target = resolve(path);
|
||||
return target === base || target.startsWith(base + sep);
|
||||
}
|
||||
Reference in new issue
Block a user