@jini-ai/agent-runtime 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * @module types
+ *
+ * The central, product-neutral contract for this package: `RuntimeAgentDef`
+ * declaratively describes how to detect, authenticate, and spawn a single
+ * coding-agent CLI (Claude Code, Codex, Cursor, Aider, AMR, …). Everything
+ * else in `@jini-ai/agent-runtime` — the registry, detection, launch, and
+ * stream-parsing modules — operates on this type or on `DetectedAgent`, its
+ * runtime-probed sibling.
+ *
+ * Ported from OD's `apps/daemon/src/runtimes/core/types.ts`. Product-neutral
+ * as found — see `source-map.md` for the full provenance table.
+ */
+import type { ExecFileOptions } from 'node:child_process';
+export type RuntimeEnv = NodeJS.ProcessEnv | Record<string, string>;
+export type RuntimeModelOption = {
+    id: string;
+    label: string;
+};
+export type RuntimeModelSource = 'live' | 'fallback';
+export type RuntimeReasoningOption = RuntimeModelOption;
+export type RuntimeBuildOptions = {
+    model?: string | null;
+    reasoning?: string | null;
+};
+export type RuntimeContext = {
+    cwd?: string;
+    hasPriorAssistantTurn?: boolean;
+    agentLogFilePath?: string;
+    antigravitySettingsPath?: string;
+    promptFilePath?: string;
+    resumeSessionId?: string | null;
+    newSessionId?: string;
+};
+export type RuntimeCapabilityMap = Record<string, boolean>;
+export type RuntimeListModels = {
+    args: string[];
+    timeoutMs: number;
+    parse: (stdout: string) => RuntimeModelOption[] | null;
+};
+export type RuntimePromptBudgetError = {
+    code: 'AGENT_PROMPT_TOO_LARGE';
+    message: string;
+    bytes?: number;
+    commandLineLength?: number;
+    limit: number;
+};
+export type RuntimeAgentDef = {
+    id: string;
+    name: string;
+    bin: string;
+    versionArgs: string[];
+    fallbackModels: RuntimeModelOption[];
+    buildArgs: (prompt: string, imagePaths: string[], extraAllowedDirs?: string[], options?: RuntimeBuildOptions, runtimeContext?: RuntimeContext) => string[];
+    streamFormat: string;
+    fallbackBins?: string[];
+    versionProbeTimeoutMs?: number;
+    helpArgs?: string[];
+    capabilityFlags?: Record<string, string>;
+    promptViaFile?: boolean;
+    promptViaStdin?: boolean;
+    promptInputFormat?: 'text' | 'stream-json';
+    eventParser?: string;
+    env?: Record<string, string>;
+    listModels?: RuntimeListModels;
+    fetchModels?: (resolvedBin: string, env: RuntimeEnv) => Promise<RuntimeModelOption[] | null>;
+    reasoningOptions?: RuntimeReasoningOption[];
+    supportsImagePaths?: boolean;
+    maxPromptArgBytes?: number;
+    mcpDiscovery?: string;
+    externalMcpInjection?: 'claude-mcp-json' | 'acp-merge' | 'opencode-env-content' | 'mimo-env-content';
+    installUrl?: string;
+    docsUrl?: string;
+    supportsCustomModel?: boolean;
+    resumesSessionViaCli?: boolean;
+    capturesSessionIdFromStream?: boolean;
+    resumesSessionViaAcpLoad?: boolean;
+    defaultModelEnvVar?: string;
+    inactivityTimeoutMs?: number;
+    authProbe?: {
+        args: string[];
+        timeoutMs?: number;
+    };
+    acpMcpEnvFormat?: 'array' | 'map';
+};
+export type DetectedAgent = Omit<RuntimeAgentDef, 'buildArgs' | 'listModels' | 'fetchModels' | 'fallbackModels' | 'helpArgs' | 'capabilityFlags' | 'fallbackBins' | 'versionProbeTimeoutMs' | 'maxPromptArgBytes' | 'env' | 'inactivityTimeoutMs' | 'authProbe'> & {
+    models: RuntimeModelOption[];
+    modelsSource: RuntimeModelSource;
+    available: boolean;
+    authStatus?: 'ok' | 'missing' | 'unknown';
+    authMessage?: string;
+    path?: string;
+    version?: string | null;
+    diagnostics?: AgentDiagnostic[];
+};
+export type RuntimeExecOptions = ExecFileOptions & {
+    env?: NodeJS.ProcessEnv;
+};
+/**
+ * A typed "what should the UI do to fix this" intent attached to an
+ * {@link AgentDiagnostic}. The UI renders a button per intent and owns the
+ * concrete handler (open a URL, re-run detection, write an env override,
+ * launch an OAuth terminal flow). Keeping the intent typed — rather than a
+ * pre-baked button label + URL — lets multiple surfaces (a settings card,
+ * an unavailable-agents grid, a CLI healthcheck) render the same fix
+ * affordances from one source of truth instead of each re-deriving copy
+ * and wiring.
+ *
+ * Vendored (minimal, unmodified shape) from OD's
+ * `packages/contracts/src/api/registry.ts#AgentFixIntent` — see
+ * `source-map.md`. `@jini-ai/agent-runtime` does not depend on OD's
+ * contracts workspace package.
+ */
+export type AgentFixIntent = 
+/** Open the agent's configuration / auth docs (`AgentInfo.docsUrl`). */
+{
+    kind: 'openDocs';
+}
+/** Open the agent's install / download page (`AgentInfo.installUrl`). */
+ | {
+    kind: 'openInstall';
+}
+/** Re-run agent detection (a Settings "Rescan" affordance). */
+ | {
+    kind: 'rescan';
+}
+/**
+ * Prompt the user to point the host application at an explicit binary by
+ * writing `envKey` (e.g. `CURSOR_AGENT_BIN`) into a configured-env store.
+ * Used when the CLI is installed somewhere PATH detection can't reach.
+ */
+ | {
+    kind: 'setEnv';
+    envKey: string;
+}
+/** Clear a previously-set binary override so detection falls back to PATH. */
+ | {
+    kind: 'clearEnv';
+    envKey: string;
+}
+/**
+ * Launch the agent's interactive sign-in in a system terminal (used by
+ * adapters whose OAuth flow cannot complete in a headless/print mode).
+ */
+ | {
+    kind: 'launchOAuth';
+    agentId: string;
+};
+export type AgentDiagnosticReason = 
+/** The binary (and any fallback names) was not found on PATH. */
+'not-on-path'
+/** A file matched but is not executable (missing +x / wrong PATHEXT). */
+ | 'not-executable'
+/** A wrapper/shim was found but its target is gone (exit 126/127). */
+ | 'shim-broken'
+/** A user-set `*_BIN` override points at a missing/invalid file. */
+ | 'configured-bin-invalid'
+/** Installed and invocable, but the CLI is not authenticated. */
+ | 'auth-missing'
+/** Installed, but auth status could not be verified. */
+ | 'auth-unknown';
+export type AgentDiagnosticSeverity = 'error' | 'warning' | 'info';
+/**
+ * Why a CLI agent is unavailable or only partially usable, in a shape a UI
+ * can render as "one-line reason + fix button(s)" instead of a silent grey
+ * card. Vendored from OD's contracts workspace package — see
+ * `AgentFixIntent`'s doc comment.
+ */
+export interface AgentDiagnostic {
+    reason: AgentDiagnosticReason;
+    severity: AgentDiagnosticSeverity;
+    /** Short, human-readable, single-sentence explanation. */
+    message: string;
+    /** Optional longer context (e.g. the probe's stderr tail). */
+    detail?: string;
+    /**
+     * Directories PATH detection searched, surfaced verbatim for the
+     * `not-on-path` case so the user can see where detection looked before
+     * being asked to set an explicit binary path.
+     */
+    searchedDirs?: string[];
+    /** Ordered fix affordances the UI should offer for this diagnostic. */
+    fixActions?: AgentFixIntent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@jini-ai/agent-runtime",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AINSEP/Jini.git",
+    "directory": "packages/agent-runtime"
+  },
+  "jini": {
+    "domain": "agent",
+    "kind": "runtime",
+    "runtime": "node",
+    "admission": "locked"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/__tests__/**"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@jini-ai/platform": "0.1.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  }
+}