@tangle-network/cli-agent-registry 0.0.0-stage → 0.14.0

package/dist/index.mjs

@@ -0,0 +1,146 @@
+import { a as HARNESSES, i as configDirHomeEnv, n as HARNESS_SESSION_UNSUPPORTED, r as NATIVE_SESSION_CONTRACTS, t as HARNESS_CONFORMANCE_PENDING } from "./native-session-contracts-DWFzgoye.mjs";
+import { HarnessSessionContractError, SESSION_FORMAT_IDS, assertArgvHonoursSessionContract, assertFlagsHonourSessionContract, assertStoreLocationHonoursSessionContract, compileSessionStoreGlob, forbiddenArgViolations, normalizePosixPath, sessionContractProblems, sessionStoreForPath, substituteNativeSessionId } from "./session-contract.mjs";
+import { a as parseBackendType, i as isBackendType, n as BACKEND_TYPE, r as backendTypeSchema, t as ALL_BACKEND_TYPES } from "./backend-types-CREj4iOY.mjs";
+import { a as agentProfileSchema, c as cliAgentHostPassthroughEnvVarNames, d as canonicalModelSlug, f as cliAgentClaimEnvVarNames, g as SYNTHETIC_ROUTER_MODEL, h as harnessModelWire, i as MANAGED_MODEL_KEY_NAME_ENV_VAR, l as getSpec, m as harnessModelSupportFor, n as CLI_AGENT_SPECS, o as claimDeliverableEnvVarNames, p as cliAgentEnvRoleName, r as MANAGED_MODEL_KEY_ENV_VAR, s as cliAgentEnvVarNamesByRole, t as AGENT_BACKEND_ENV_VAR, u as messageStorageDirOf } from "./specs-Bbiay_8K.mjs";
+import { materializeCliAuthBundle } from "./cli-auth-bundle.mjs";
+import { resolveDefaultBackend } from "./default-backend.mjs";
+import { describeLocalCliAuthExpectation, discoverLocalCliAuthFiles } from "./local-cli-auth.mjs";
+import { MANAGED_MODEL_LADDER, bareModelId, isServableManagedModel, managedModelChain } from "./servable-models.mjs";
+import { z } from "zod";
+//#region src/adapter-bindings.ts
+/**
+* A composition-owned factory map. Wiring requirements come from this selected
+* catalog, not every harness known elsewhere. No provider implementation is
+* imported here, and separate registries cannot overwrite each other's bindings.
+*
+* Registration itself does not authorize execution. As with the existing API,
+* factories may be staged before catalog admission; callers must still resolve
+* a selected spec and enforce its capabilities before dispatching a request.
+* Unregistering a required factory is not retirement: select a new composition
+* after draining its sessions rather than weakening the wiring invariant.
+*/
+function createAdapterRegistry(specs) {
+	const selected = /* @__PURE__ */ new Map();
+	for (const spec of specs) {
+		if (selected.has(spec.name)) throw new Error(`cli-agent-registry: duplicate spec "${spec.name}"`);
+		selected.set(spec.name, {
+			sessions: spec.capabilities.sessions,
+			nativeSession: spec.nativeSession != null
+		});
+	}
+	const factories = /* @__PURE__ */ new Map();
+	function assertSessionContractDeclared(name) {
+		const spec = selected.get(name);
+		if (!spec?.sessions || spec.nativeSession) return;
+		if (Object.hasOwn(HARNESS_SESSION_UNSUPPORTED, name)) return;
+		throw new HarnessSessionContractError("harness_session_contract_missing", `${name} runs sessions but declares no nativeSession contract`);
+	}
+	return {
+		registerAdapterFactory(name, factory, options) {
+			assertSessionContractDeclared(name);
+			if (factories.has(name) && !options?.force) throw new Error(`cli-agent-registry: adapter factory for "${name}" already registered. Pass { force: true } to override (test stubs only) or call unregisterAdapterFactory() first.`);
+			factories.set(name, factory);
+		},
+		unregisterAdapterFactory(name) {
+			return factories.delete(name);
+		},
+		getAdapterFactory(name) {
+			return factories.get(name);
+		},
+		listRegisteredAdapters() {
+			return Array.from(factories.keys());
+		},
+		assertAdaptersWired() {
+			const missing = [];
+			for (const [name, spec] of selected) {
+				assertSessionContractDeclared(name);
+				if (spec.sessions && !factories.has(name)) missing.push(name);
+			}
+			if (missing.length > 0) throw new Error(`cli-agent-registry: executable backend specs without an adapter factory registered: ${missing.join(", ")}. Register each selected adapter in the composition root before startup.`);
+		}
+	};
+}
+const defaultRegistry = createAdapterRegistry(CLI_AGENT_SPECS);
+function registerAdapterFactory(name, factory, options) {
+	defaultRegistry.registerAdapterFactory(name, factory, options);
+}
+function unregisterAdapterFactory(name) {
+	return defaultRegistry.unregisterAdapterFactory(name);
+}
+function getAdapterFactory(name) {
+	return defaultRegistry.getAdapterFactory(name);
+}
+function listRegisteredAdapters() {
+	return defaultRegistry.listRegisteredAdapters();
+}
+function assertAdaptersWired() {
+	defaultRegistry.assertAdaptersWired();
+}
+//#endregion
+//#region src/agent-run-request.ts
+/** A backend carries an inline profile, a profile digest, or neither. */
+function agentRunBackendVariants(base) {
+	return z.union([
+		z.object({
+			...base,
+			profile: agentProfileSchema
+		}).strict(),
+		z.object({
+			...base,
+			profileSha256: z.string().regex(/^[a-f0-9]{64}$/, "profileSha256 must be a lowercase SHA-256")
+		}).strict(),
+		z.object(base).strict()
+	]);
+}
+const agentRunWorkspaceSchema = z.object({
+	rootPath: z.string().optional(),
+	debugDirectory: z.string().optional(),
+	skipInitialization: z.boolean().optional(),
+	cleanupOnShutdown: z.boolean().optional()
+});
+/** The shared request fields, in wire order around each end's workspace and backend. */
+function agentRunRequestSharedShape(workspace, backend) {
+	return {
+		sessionId: z.string().optional(),
+		displayName: z.string().optional(),
+		description: z.string().optional(),
+		domains: z.array(z.string()).optional(),
+		workspace,
+		backend,
+		expectedPublicProfileRequestDigest: z.string().regex(/^sha256:[a-f0-9]{64}$/).optional(),
+		expectedSecretProfileReceipt: z.string().regex(/^hmac-sha256:[a-f0-9]{64}$/).optional(),
+		githubToken: z.string().optional(),
+		metadata: z.record(z.string(), z.unknown()).optional()
+	};
+}
+//#endregion
+//#region src/cli-dir-layout.ts
+/** What every CLI's directory is read with; a spec adds its own entries. */
+const DEFAULT_CLI_DIR_LAYOUT = {
+	sessionData: ["messages/**", "history.jsonl"],
+	configAllow: [
+		"config.toml",
+		"settings.json",
+		"settings.local.json",
+		"opencode.jsonc",
+		"package.json",
+		"package-lock.json",
+		"models_cache.json",
+		"installation_id",
+		"version.json",
+		".personality_migration"
+	],
+	credential: []
+};
+/** The default layout with a spec's additions. */
+function mergeCliDirLayout(additions) {
+	return {
+		sessionData: [...DEFAULT_CLI_DIR_LAYOUT.sessionData, ...additions?.sessionData ?? []],
+		configAllow: [...DEFAULT_CLI_DIR_LAYOUT.configAllow, ...additions?.configAllow ?? []],
+		credential: [...DEFAULT_CLI_DIR_LAYOUT.credential, ...additions?.credential ?? []]
+	};
+}
+//#endregion
+export { AGENT_BACKEND_ENV_VAR, ALL_BACKEND_TYPES, BACKEND_TYPE, CLI_AGENT_SPECS, DEFAULT_CLI_DIR_LAYOUT, HARNESSES, HARNESS_CONFORMANCE_PENDING, HARNESS_SESSION_UNSUPPORTED, HarnessSessionContractError, MANAGED_MODEL_KEY_ENV_VAR, MANAGED_MODEL_KEY_NAME_ENV_VAR, MANAGED_MODEL_LADDER, NATIVE_SESSION_CONTRACTS, SESSION_FORMAT_IDS, SYNTHETIC_ROUTER_MODEL, agentProfileSchema, agentRunBackendVariants, agentRunRequestSharedShape, agentRunWorkspaceSchema, assertAdaptersWired, assertArgvHonoursSessionContract, assertFlagsHonourSessionContract, assertStoreLocationHonoursSessionContract, backendTypeSchema, bareModelId, canonicalModelSlug, claimDeliverableEnvVarNames, cliAgentClaimEnvVarNames, cliAgentEnvRoleName, cliAgentEnvVarNamesByRole, cliAgentHostPassthroughEnvVarNames, compileSessionStoreGlob, configDirHomeEnv, createAdapterRegistry, describeLocalCliAuthExpectation, discoverLocalCliAuthFiles, forbiddenArgViolations, getAdapterFactory, getSpec, harnessModelSupportFor, harnessModelWire, isBackendType, isServableManagedModel, listRegisteredAdapters, managedModelChain, materializeCliAuthBundle, mergeCliDirLayout, messageStorageDirOf, normalizePosixPath, parseBackendType, registerAdapterFactory, resolveDefaultBackend, sessionContractProblems, sessionStoreForPath, substituteNativeSessionId, unregisterAdapterFactory };
+
+//# sourceMappingURL=index.mjs.map

package/dist/local-cli-auth.d.mts

@@ -0,0 +1,14 @@
+import { LocalCliAuthFile } from "./cli-auth-bundle.mjs";
+
+//#region src/local-cli-auth.d.ts
+type LocalCliAuthBackend = "codex" | "claude-code";
+type DiscoverOptions = {
+  homeDir?: string;
+  env?: Readonly<Record<string, string | undefined>>;
+  credentialOnly?: boolean;
+};
+declare function discoverLocalCliAuthFiles(backendType: LocalCliAuthBackend, options?: DiscoverOptions): LocalCliAuthFile[] | undefined;
+declare function describeLocalCliAuthExpectation(backendType: LocalCliAuthBackend): string;
+//#endregion
+export { type LocalCliAuthFile, describeLocalCliAuthExpectation, discoverLocalCliAuthFiles };
+//# sourceMappingURL=local-cli-auth.d.mts.map

package/dist/local-cli-auth.mjs

@@ -0,0 +1,31 @@
+import { AUTH_BUNDLE_PATHS } from "./cli-auth-bundle.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+//#region src/local-cli-auth.ts
+const DEFAULT_MODE = 384;
+function readAuthFile(sourcePath, targetPath) {
+	if (!existsSync(sourcePath)) return null;
+	return {
+		path: targetPath,
+		content: readFileSync(sourcePath, "utf-8"),
+		mode: DEFAULT_MODE
+	};
+}
+function discoverLocalCliAuthFiles(backendType, options = {}) {
+	const env = options.env ?? (options.homeDir === void 0 ? process.env : {});
+	const homeDir = options.homeDir ?? (env.HOME || homedir());
+	const authPath = AUTH_BUNDLE_PATHS[backendType];
+	const configDir = env[backendType === "codex" ? "CODEX_HOME" : "CLAUDE_CONFIG_DIR"] || join(homeDir, dirname(authPath));
+	const credentialDir = backendType === "claude-code" ? env.CLAUDE_SECURESTORAGE_CONFIG_DIR || configDir : configDir;
+	const authFiles = [authPath, ...backendType === "claude-code" && !options.credentialOnly ? [".claude/settings.json", ".claude/settings.local.json"] : []].map((path) => readAuthFile(join(path === authPath ? credentialDir : configDir, basename(path)), path)).filter((entry) => entry !== null);
+	return authFiles.length > 0 ? authFiles : void 0;
+}
+function describeLocalCliAuthExpectation(backendType) {
+	if (backendType === "codex") return "auth.json in CODEX_HOME, or ~/.codex when CODEX_HOME is unset";
+	return "Claude credential files in CLAUDE_SECURESTORAGE_CONFIG_DIR or CLAUDE_CONFIG_DIR (default ~/.claude)";
+}
+//#endregion
+export { describeLocalCliAuthExpectation, discoverLocalCliAuthFiles };
+
+//# sourceMappingURL=local-cli-auth.mjs.map