@tangle-network/agent-interface 0.43.1 → 0.45.0

package/README.md

@@ -48,6 +48,12 @@ The older `checkpoint()` and `fork()` methods remain source-compatible for provi
 All new wire values have exported Zod schemas on the package root.
 Omitting `interactions` and `nativeContinuation`, or leaving the three durable branching flags false, is the compatible declaration for existing providers.
 
+`profile.systemPrompt` declares two independent bits rather than one flag.
+`replace` means the provider deletes the harness's own system prompt and installs `prompt.systemPrompt`; `append` means it keeps that prompt and adds `prompt.appendSystemPrompt` to it.
+A provider that can only append must declare `replace: false` and refuse a profile carrying `systemPrompt`, because quietly appending a requested replacement leaves the instructions the caller asked to delete in force.
+
+
+
 ## Install
 
 ```bash
@@ -77,7 +83,8 @@ const provider: AgentEnvironmentProvider = {
   capabilities: () => ({
     profile: {
       namedProfiles: false,
-      systemPrompt: true,
+      // Most harnesses can only add to their built-in prompt, not delete it.
+      systemPrompt: { replace: false, append: true },
       instructions: true,
       tools: true,
       permissions: true,

package/dist/agent-candidate-code-schema.d.ts

@@ -161,6 +161,7 @@ export declare const agentCandidateExecutionSchema: z.ZodObject<{
         opencode: "opencode";
         "kimi-code": "kimi-code";
         pi: "pi";
+        prime: "prime";
         gemini: "gemini";
         hermes: "hermes";
         openclaw: "openclaw";

package/dist/agent-candidate-execution-plan-schema.d.ts

@@ -69,6 +69,7 @@ export declare const agentCandidateProfilePlanMaterialSchema: z.ZodObject<{
         opencode: "opencode";
         "kimi-code": "kimi-code";
         pi: "pi";
+        prime: "prime";
         gemini: "gemini";
         hermes: "hermes";
         openclaw: "openclaw";
@@ -96,6 +97,10 @@ export declare const agentCandidateProfilePlanMaterialSchema: z.ZodObject<{
         kind: z.ZodLiteral<"public">;
         value: z.ZodString;
     }, z.core.$strict>>;
+    appendSystemPrompt: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"public">;
+        value: z.ZodString;
+    }, z.core.$strict>>;
     unsupported: z.ZodArray<z.ZodObject<{
         dimension: z.ZodString;
         reason: z.ZodString;
@@ -328,6 +333,7 @@ export declare const agentCandidateExecutionPlanMaterialSchema: z.ZodObject<{
         opencode: "opencode";
         "kimi-code": "kimi-code";
         pi: "pi";
+        prime: "prime";
         gemini: "gemini";
         hermes: "hermes";
         openclaw: "openclaw";
@@ -523,7 +529,7 @@ export declare const agentCandidateProfilePlanEvidenceSchema: z.ZodObject<{
     digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
     material: z.ZodType<{
         sourceProfileDigest: `sha256:${string}`;
-        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
+        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
         files: {
             relPath: string;
             mode: number;
@@ -545,9 +551,13 @@ export declare const agentCandidateProfilePlanEvidenceSchema: z.ZodObject<{
             kind: "public";
             value: string;
         } | undefined;
+        appendSystemPrompt?: {
+            kind: "public";
+            value: string;
+        } | undefined;
     }, unknown, z.core.$ZodTypeInternals<{
         sourceProfileDigest: `sha256:${string}`;
-        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
+        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
         files: {
             relPath: string;
             mode: number;
@@ -569,6 +579,10 @@ export declare const agentCandidateProfilePlanEvidenceSchema: z.ZodObject<{
             kind: "public";
             value: string;
         } | undefined;
+        appendSystemPrompt?: {
+            kind: "public";
+            value: string;
+        } | undefined;
     }, unknown>>;
     artifact: z.ZodUnion<readonly [z.ZodObject<{
         locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -596,7 +610,7 @@ export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
         digest: `sha256:${string}`;
         material: {
             sourceProfileDigest: `sha256:${string}`;
-            harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
+            harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
             files: {
                 relPath: string;
                 mode: number;
@@ -618,6 +632,10 @@ export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
                 kind: "public";
                 value: string;
             } | undefined;
+            appendSystemPrompt?: {
+                kind: "public";
+                value: string;
+            } | undefined;
         };
         artifact: {
             locator: {
@@ -643,7 +661,7 @@ export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
         digest: `sha256:${string}`;
         material: {
             sourceProfileDigest: `sha256:${string}`;
-            harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
+            harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
             files: {
                 relPath: string;
                 mode: number;
@@ -665,6 +683,10 @@ export declare const agentCandidateProfileActivationSchema: z.ZodObject<{
                 kind: "public";
                 value: string;
             } | undefined;
+            appendSystemPrompt?: {
+                kind: "public";
+                value: string;
+            } | undefined;
         };
         artifact: {
             locator: {
@@ -723,7 +745,7 @@ export declare const agentCandidateExecutionPlanEvidenceSchema: z.ZodObject<{
             targetWorkspace: "candidate" | "task";
             mountPaths: string[];
         };
-        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
+        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
         harnessVersion: string;
         instructionDelivery: {
             kind: "argv-append";
@@ -966,7 +988,7 @@ export declare const agentCandidateExecutionPlanEvidenceSchema: z.ZodObject<{
             targetWorkspace: "candidate" | "task";
             mountPaths: string[];
         };
-        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
+        harness: "claude-code" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "pi" | "prime" | "gemini" | "hermes" | "openclaw" | "amp" | "factory-droids" | "forge" | "cursor" | "acp" | "cli-base";
         harnessVersion: string;
         instructionDelivery: {
             kind: "argv-append";

package/dist/agent-candidate-execution-plan-schema.js

@@ -117,6 +117,7 @@ export const agentCandidateProfilePlanMaterialSchema = z
     env: environmentConfigSchema,
     flags: z.array(agentCandidateConfigValueSchema),
     systemPrompt: agentCandidateConfigValueSchema.optional(),
+    appendSystemPrompt: agentCandidateConfigValueSchema.optional(),
     unsupported: z
         .array(z
         .object({

package/dist/agent-candidate-profile-schema.d.ts

@@ -22,6 +22,7 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     prompt: z.ZodOptional<z.ZodObject<{
         systemPrompt: z.ZodOptional<z.ZodString>;
+        appendSystemPrompt: z.ZodOptional<z.ZodString>;
         instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
     model: z.ZodOptional<z.ZodObject<{
@@ -45,6 +46,7 @@ export declare const agentCandidateProfileSchema: z.ZodObject<{
         opencode: "opencode";
         "kimi-code": "kimi-code";
         pi: "pi";
+        prime: "prime";
         gemini: "gemini";
         hermes: "hermes";
         openclaw: "openclaw";