@agentoryhq/runtime-contract 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import type { AlignPatch, DiscoveredAgent, MemoryIndexReportItem, SessionIndexReportItem, TranscriptSnapshot } from "@agentoryhq/shared";
 /** Wire protocol version between Host and RuntimeAdapter implementations. */
 export declare const ADAPTER_API_VERSION: 1;
-export type AdapterCapability = "detect" | "discoverConfig" | "applyAlign" | "indexSessions" | "readTranscript" | "handoffExport";
+export type AdapterCapability = "detect" | "discoverConfig" | "applyAlign" | "indexSessions" | "readTranscript" | "handoffExport" | "invoke";
 export type AdapterManifest = {
     /** Matches control-plane / shared RuntimeKind when known. */
     runtime: string;
@@ -25,11 +25,42 @@ export type ApplyAlignResult = {
     mcpPath: string;
     skillsPath: string;
     snapshotPath?: string;
+    /** 规则写盘目录(rules-desired-config,cursor-only;未写规则时缺省) */
+    rulesDir?: string;
+    /** 被覆盖规则文件的快照目录(rules-<ts>/;无覆盖时缺省) */
+    rulesSnapshotDir?: string;
 };
 export type AssetIndexResult = {
     sessions: SessionIndexReportItem[];
     memories: MemoryIndexReportItem[];
 };
+/** Outcome of one headless execution requested via `invoke`. */
+export type InvokeOutcome = "done" | "failed" | "timeout";
+export type InvokeRequest = {
+    /** Task text sent to the runtime (单发单执行；一期不带上文). */
+    prompt: string;
+    /** Wall-clock execution budget; adapter MUST kill the process (group) on expiry. */
+    timeoutMs: number;
+    /** Cap on captured output; adapter truncates and sets `truncated`. */
+    maxOutputBytes: number;
+    /** Project directory the runtime executes in (Agent 实例根). */
+    cwd: string;
+    /** 二期预留（thread resume）；一期调用方不得设置。 */
+    resumeSessionId?: string;
+};
+export type InvokeResult = {
+    outcome: InvokeOutcome;
+    /** Captured stdout+stderr, possibly truncated. Never contains secrets in plaintext. */
+    output: string;
+    truncated: boolean;
+    /** Process exit code; null when killed by signal (timeout) or not spawned. */
+    exitCode: number | null;
+    durationMs: number;
+    /** Runtime's own session id when obtainable; reserved for 二期 resume. */
+    runtimeSessionId?: string;
+    /** Short failure summary for `failed` / `timeout`. */
+    errorText?: string;
+};
 /**
  * Per-runtime adapter. Host orchestrates; adapters own paths and formats.
  * Optional methods must match declared `capabilities`.
@@ -42,5 +73,13 @@ export type RuntimeAdapter = {
     indexSessions?(ctx: AdapterContext): AssetIndexResult;
     transcriptFileForSourceKey?(sourceKey: string, homeDir?: string): string | undefined;
     captureTranscriptSnapshot?(file: string, now?: Date): TranscriptSnapshot | undefined;
+    /**
+     * Execute one headless task (agent-messaging). Async on purpose: executions
+     * may run up to `timeoutMs` (~minutes) and MUST NOT block the daemon event
+     * loop — heartbeats keep flowing while a task runs.
+     * Red line (ADR-005): run with the runtime's DEFAULT permission model;
+     * never inject permission-relaxing flags (`--dangerously-skip-permissions` 类).
+     */
+    invoke?(ctx: AdapterContext, req: InvokeRequest): Promise<InvokeResult>;
 };
 export declare function hasCapability(manifest: AdapterManifest, cap: AdapterCapability): boolean;

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@agentoryhq/runtime-contract",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Agentory RuntimeAdapter contract (manifest + capabilities)",
   "license": "Apache-2.0",
   "type": "module",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,8 +21,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tunsuy/agentory-node.git",
-    "directory": "packages/runtime-contract"
+    "url": "git+https://github.com/tunsuy/agentory-node.git"
   },
   "publishConfig": {
     "access": "public"