@tangle-network/agent-profile-materialize 0.4.0 → 0.5.1

package/dist/index.d.ts

@@ -21,7 +21,7 @@
  * `node:fs` IO consumer. It was previously copied byte-for-byte into both
  * cli-bridge and agent-dev-container — this is the single source those re-export.
  */
-import type { AgentCandidateConfigValue, AgentCandidateProfile, AgentCandidateProfileApplication, AgentCandidateProfilePlanEvidence, AgentProfile, Sha256Digest } from "@tangle-network/agent-interface";
+import type { AgentCandidateConfigValue, AgentCandidateProfile, AgentCandidateProfileActivation, AgentCandidateProfileApplication, AgentCandidateProfilePlanEvidence, AgentCandidateProfilePlanMaterial, AgentProfile, AgentProfileMcpServer, Sha256Digest } from "@tangle-network/agent-interface";
 export type HarnessId = "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw";
 export interface PlanFile {
     relPath: string;
@@ -30,7 +30,7 @@ export interface PlanFile {
     mode?: number;
 }
 export interface Unsupported {
-    dimension: "files" | "skills" | "mcp" | "hooks" | "subagents" | "commands" | "instructions" | "systemPrompt" | "permissions" | "tools";
+    dimension: "files" | "skills" | "mcp" | "hooks" | "subagents" | "commands" | "instructions" | "systemPrompt" | "connections" | "confidential" | "permissions" | "tools" | "modes" | "extensions";
     reason: string;
 }
 /** The plan a caller writes into the run cwd, then applies to the spawn. */
@@ -42,6 +42,8 @@ export interface WorkspacePlan {
     env: Record<string, string>;
     /** Extra CLI flags to pass (e.g. kimi --mcp-config-file <path>). */
     flags: string[];
+    /** Exact system-prompt replacement supplied to the harness. */
+    systemPrompt?: string;
     /** Dimensions requested but with NO cwd path on this harness — fail-closed record. */
     unsupported: Unsupported[];
 }
@@ -54,31 +56,57 @@ export interface WorkspacePlanReceipt {
     workspacePlanDigest: string;
     env: Record<string, string>;
     flags: string[];
+    systemPrompt?: string;
     unsupported: Unsupported[];
     written: string[];
 }
+/** The plan was applied, but one or more private staging files remain. */
+export declare class WorkspacePlanCleanupError extends AggregateError {
+    readonly receipt: WorkspacePlanReceipt;
+    readonly temporaryPaths: readonly string[];
+    constructor(errors: readonly unknown[], receipt: WorkspacePlanReceipt, temporaryPaths: readonly string[]);
+}
+export interface ApplyWorkspacePlanOptions {
+    /** Plan files consumed in memory by the runtime and never persisted to cwd. */
+    runtimeOnlyFiles?: readonly string[];
+    /** Existing workspace paths are either exact idempotent inputs or forbidden. */
+    existingFiles?: "allow-identical" | "reject";
+}
+/** Fail when a profile asks for controls the chosen harness cannot execute. */
+export declare function assertWorkspacePlanSupported(plan: Pick<WorkspacePlan, "unsupported">): void;
 /**
  * Candidate-safe workspace plan. Spawn values remain typed until the runtime
  * resolves them; the materializer never joins argv into a shell command.
  */
 export interface AgentCandidateWorkspacePlan {
+    sourceProfileDigest: Sha256Digest;
     harness: HarnessId;
     files: PlanFile[];
     env: Record<string, AgentCandidateConfigValue>;
     flags: AgentCandidateConfigValue[];
+    systemPrompt?: AgentCandidateConfigValue;
     unsupported: Unsupported[];
 }
 export interface AgentCandidateWorkspacePlanReceipt {
-    profilePlan: AgentCandidateProfilePlanEvidence;
+    profileActivation: AgentCandidateProfileActivation;
     application: AgentCandidateProfileApplication;
     env: Record<string, AgentCandidateConfigValue>;
     flags: AgentCandidateConfigValue[];
+    systemPrompt?: AgentCandidateConfigValue;
     unsupported: Unsupported[];
 }
 export interface MaterializeCandidateProfileOptions {
     /** Exact text fetched from pinned resource refs, keyed by declared SHA-256. */
     resolvedResources?: ReadonlyMap<Sha256Digest, string>;
 }
+export interface ResolveAgentProfileResourcesOptions {
+    /** Repository used when a GitHub resource omits its own `repository`. */
+    repository?: string;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+}
+/** Resolve every GitHub resource to exact inline bytes before materialization. */
+export declare function resolveAgentProfileResources(inputProfile: AgentProfile, options?: ResolveAgentProfileResourcesOptions): Promise<AgentProfile>;
 /** Normalize any skill markdown (VB frontmatter `skill:`/`description:`, or raw) into a
  *  harness SKILL.md with `name:`/`description:` frontmatter the harnesses require. */
 export declare function normalizeSkillMd(name: string, raw: string): string;
@@ -86,14 +114,13 @@ export declare function normalizeSkillMd(name: string, raw: string): string;
  * Build the WorkspacePlan for `profile` on `harness`. Pure — no IO. The caller
  * writes plan.files into the run cwd and applies plan.env/plan.flags to the spawn.
  */
-export declare function materializeProfile(profile: AgentProfile, harness: HarnessId, opts?: {
+export declare function materializeProfile(inputProfile: AgentProfile, harness: HarnessId, opts?: {
     skip?: Unsupported["dimension"][];
 }): WorkspacePlan;
 /**
  * Materialize a sealed candidate profile without weakening its process values.
- * Candidate hooks deliberately fail closed because the currently supported
- * native hook formats accept a shell command string rather than executable +
- * argv + env as separate fields.
+ * Codex and Claude hooks use generated no-shell wrappers to preserve executable,
+ * argv, and environment values separately. Other hook formats fail closed.
  */
 export declare function materializeCandidateProfile(profile: AgentCandidateProfile, harness: HarnessId, opts?: MaterializeCandidateProfileOptions): AgentCandidateWorkspacePlan;
 /**
@@ -103,13 +130,13 @@ export declare function materializeCandidateProfile(profile: AgentCandidateProfi
  */
 export declare function hashWorkspacePlan(plan: WorkspacePlan): string;
 /** Build the exact digest-free identity document required by agent-interface. */
-export declare function agentCandidateProfilePlanMaterial(plan: AgentCandidateWorkspacePlan): AgentCandidateProfilePlanEvidence["material"];
+export declare function agentCandidateProfilePlanMaterial(plan: AgentCandidateWorkspacePlan): AgentCandidateProfilePlanMaterial;
 /**
  * Return the RFC 8785 UTF-8 bytes and SHA-256 identity of a candidate profile
  * plan. The returned bytes are the exact bytes embedded in receipt evidence.
  */
 export declare function canonicalizeAgentCandidateProfilePlan(plan: AgentCandidateWorkspacePlan): {
-    material: AgentCandidateProfilePlanEvidence["material"];
+    material: AgentCandidateProfilePlanMaterial;
     bytes: Uint8Array;
     digest: Sha256Digest;
 };
@@ -126,4 +153,18 @@ export declare function applyAgentCandidateWorkspacePlan(plan: AgentCandidateWor
  * consumer of the pure `materializeProfile` — used by the cli-bridge host spawn, the
  * agent-dev-container box, and VB. Returns `unsupported` so the caller can log/fail.
  */
-export declare function applyWorkspacePlan(plan: WorkspacePlan, workspaceDir: string): WorkspacePlanReceipt;
+export declare function applyWorkspacePlan(plan: WorkspacePlan, workspaceDir: string, options?: ApplyWorkspacePlanOptions): WorkspacePlanReceipt;
+/** OpenCode-native MCP configuration used by workspace and startup paths. */
+export type OpenCodeMcpConfig = Record<string, {
+    type: "remote";
+    url: string;
+    enabled: boolean;
+    headers?: Record<string, string>;
+} | {
+    type: "local";
+    command: string[];
+    enabled: boolean;
+    environment?: Record<string, string>;
+}>;
+/** Lower canonical MCP definitions to OpenCode's native startup configuration. */
+export declare function openCodeMcpConfig(mcp: Record<string, AgentProfileMcpServer>): OpenCodeMcpConfig;