@ai-sdk/harness-acp 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -148,6 +148,19 @@ type ACPPermissionModeTarget = {
     readonly value: string | boolean;
 };
 type ACPPermissionModeMapping = Readonly<Record<HarnessV1PermissionMode, ACPPermissionModeTarget | null>>;
+/**
+ * Describes where an ACP implementation accepts native session instructions.
+ * Session metadata paths are relative to `_meta`; launch environment paths are
+ * relative to the parsed JSON object stored in `variable`.
+ */
+type ACPInstructionMapping = {
+    readonly type: 'session-meta';
+    readonly path: ReadonlyArray<string>;
+} | {
+    readonly type: 'launch-env-json';
+    readonly variable: string;
+    readonly path: ReadonlyArray<string>;
+};
 type ACPV1Settings = {
     readonly version?: 'v1';
     readonly harnessId: string;
@@ -166,6 +179,11 @@ type ACPV1Settings = {
     readonly authentication?: ACPAuthentication;
     readonly providerAuthentication?: ACPProviderAuthentication;
     readonly modelId?: string;
+    /**
+     * Routes HarnessAgent instructions to a runtime-native system or developer
+     * prompt. When omitted, instructions are prepended to the first user prompt.
+     */
+    readonly instructionMapping?: ACPInstructionMapping;
     readonly permissionModeMapping?: ACPPermissionModeMapping;
     readonly session?: {
         readonly meta?: Readonly<Record<string, ACPSerializableValue>>;
@@ -205,6 +223,7 @@ type ACPHarnessSettings<TBuiltinTools extends ToolSet = {}> = {
     readonly authentication?: ACPV1Settings['authentication'];
     readonly providerAuthentication?: ACPV1Settings['providerAuthentication'];
     readonly modelId?: ACPV1Settings['modelId'];
+    readonly instructionMapping?: ACPV1Settings['instructionMapping'];
     readonly permissionModeMapping?: ACPV1Settings['permissionModeMapping'];
     readonly session?: ACPV1Settings['session'];
     readonly mintBridgeToken?: ACPV1Settings['mintBridgeToken'];
@@ -213,4 +232,4 @@ declare function createACP<TBuiltinTools extends ToolSet = {}>(settings: ACPHarn
 
 declare const VERSION: string;
 
-export { type ACPAnnotations, type ACPAudioContent, type ACPAuthOptions, type ACPAuthentication, type ACPBlobResourceContents, type ACPClientApp, type ACPContentBlock, type ACPEmbeddedResource, type ACPHarnessSettings, type ACPImageContent, type ACPMetadata, type ACPNpmLockedSource, type ACPNpmSimpleSource, type ACPPermissionModeMapping, type ACPPermissionModeTarget, type ACPProfileValue, type ACPProviderAuthentication, type ACPProviderAuthenticationMode, type ACPResourceLink, type ACPRole, type ACPSerializablePrimitive, type ACPSerializableValue, type ACPSource, type ACPTextContent, type ACPTextResourceContents, type ACPToolCall, type ACPToolCallContent, type ACPToolCallLocation, type ACPToolCallStatus, type ACPToolKind, type ACPV1Settings, type ACPValueSource, VERSION, createACP };
+export { type ACPAnnotations, type ACPAudioContent, type ACPAuthOptions, type ACPAuthentication, type ACPBlobResourceContents, type ACPClientApp, type ACPContentBlock, type ACPEmbeddedResource, type ACPHarnessSettings, type ACPImageContent, type ACPInstructionMapping, type ACPMetadata, type ACPNpmLockedSource, type ACPNpmSimpleSource, type ACPPermissionModeMapping, type ACPPermissionModeTarget, type ACPProfileValue, type ACPProviderAuthentication, type ACPProviderAuthenticationMode, type ACPResourceLink, type ACPRole, type ACPSerializablePrimitive, type ACPSerializableValue, type ACPSource, type ACPTextContent, type ACPTextResourceContents, type ACPToolCall, type ACPToolCallContent, type ACPToolCallLocation, type ACPToolCallStatus, type ACPToolKind, type ACPV1Settings, type ACPValueSource, VERSION, createACP };

package/dist/index.js

@@ -518,6 +518,18 @@ var permissionModeMappingSchema = z2.object({
   "allow-edits": permissionModeTargetSchema.nullable(),
   "allow-all": permissionModeTargetSchema.nullable()
 });
+var instructionMappingPathSchema = z2.array(z2.string().min(1)).min(1);
+var instructionMappingSchema = z2.discriminatedUnion("type", [
+  z2.object({
+    type: z2.literal("session-meta"),
+    path: instructionMappingPathSchema
+  }),
+  z2.object({
+    type: z2.literal("launch-env-json"),
+    variable: z2.string().min(1),
+    path: instructionMappingPathSchema
+  })
+]);
 var acpTurnStartConfigSchema = z2.object({
   version: z2.literal(1),
   configurationFingerprint: z2.string(),
@@ -552,6 +564,8 @@ var outboundMessageSchema = z2.union([
 ]);
 var startMessageSchema = harnessV1BridgeStartBaseSchema.extend({
   prompt: z2.array(acpTextContentBlockSchema),
+  instructions: z2.string().optional(),
+  instructionMapping: instructionMappingSchema.optional(),
   mcpServers: z2.record(z2.string(), z2.unknown()).optional(),
   tools: z2.array(acpSerializableToolSpecSchema).optional(),
   builtinTools: z2.array(builtinToolSchema).readonly().default([]),
@@ -635,7 +649,8 @@ function createACPTurnStartConfig({
   mcpServers,
   debug,
   authenticationProfile,
-  sessionMeta
+  sessionMeta,
+  instructionMapping
 }) {
   return {
     version: 1,
@@ -643,6 +658,7 @@ function createACPTurnStartConfig({
       stableStringify3({
         authenticationProfile,
         sessionMeta: sessionMeta ?? null,
+        ...instructionMapping == null ? {} : { instructionMapping },
         builtinTools,
         permissionModeMapping: permissionModeMapping ?? null,
         mcpServers: mcpServers ?? null
@@ -1132,6 +1148,7 @@ function createACPV1({
               proc: void 0,
               modelId: settings.modelId,
               sessionMeta: settings.session?.meta,
+              instructionMapping: settings.instructionMapping,
               debug: startOptions.observability?.debug,
               implementationIdentity,
               authenticationProfile,
@@ -1188,6 +1205,7 @@ function createACPV1({
                   turnStartConfig,
                   authenticationProfile,
                   sessionMeta: settings.session?.meta,
+                  instructionMapping: settings.instructionMapping,
                   builtinTools: builtinToolCatalog,
                   permissionModeMapping,
                   mcpServers: settings.mcpServers
@@ -1217,6 +1235,7 @@ function createACPV1({
             permissionMode,
             authenticationProfile,
             sessionMeta: settings.session?.meta,
+            instructionMapping: settings.instructionMapping,
             builtinTools: builtinToolCatalog,
             permissionModeMapping,
             mcpServers: settings.mcpServers,
@@ -1324,6 +1343,7 @@ function createACPV1({
               builtinTools: builtinToolCatalog,
               permissionMode,
               permissionModeMapping,
+              ...settings.instructionMapping == null ? {} : { instructionMapping: settings.instructionMapping },
               ...settings.mcpServers == null ? {} : { mcpServers: settings.mcpServers },
               tools: respawnStrategy.turnStartConfig.tools,
               turnStartConfig: respawnStrategy.turnStartConfig,
@@ -1356,6 +1376,7 @@ function createACPV1({
         proc,
         modelId: settings.modelId,
         sessionMeta: settings.session?.meta,
+        instructionMapping: settings.instructionMapping,
         debug: startOptions.observability?.debug,
         implementationIdentity,
         authenticationProfile,
@@ -1517,6 +1538,7 @@ function createSession({
   proc,
   modelId,
   sessionMeta,
+  instructionMapping,
   debug,
   implementationIdentity,
   authenticationProfile,
@@ -1814,7 +1836,8 @@ function createSession({
         mcpServers,
         debug,
         authenticationProfile,
-        sessionMeta
+        sessionMeta,
+        instructionMapping
       });
       const control = wireTurn({
         emit: options.emit,
@@ -1830,9 +1853,13 @@ function createSession({
             type: "start",
             prompt: initialGuidanceApplied ? prompt : prependACPInitialGuidance({
               prompt,
-              instructions: options.instructions,
+              instructions: instructionMapping == null ? options.instructions : void 0,
               skills: skillCatalog
             }),
+            ...instructionMapping == null ? {} : {
+              instructionMapping,
+              ...options.instructions == null ? {} : { instructions: options.instructions }
+            },
             debug,
             builtinTools,
             permissionMode,
@@ -1875,6 +1902,10 @@ function createSession({
             builtinTools: turnStartConfig.builtinTools,
             permissionMode: turnStartConfig.permissionMode,
             permissionModeMapping: turnStartConfig.permissionModeMapping,
+            ...instructionMapping == null ? {} : {
+              instructionMapping,
+              ...options.instructions == null ? {} : { instructions: options.instructions }
+            },
             ...mcpServers == null ? {} : { mcpServers },
             tools: turnStartConfig.tools,
             turnStartConfig,
@@ -2007,6 +2038,7 @@ function validateACPTurnStartConfig({
   turnStartConfig,
   authenticationProfile,
   sessionMeta,
+  instructionMapping,
   builtinTools,
   permissionModeMapping,
   mcpServers
@@ -2020,7 +2052,8 @@ function validateACPTurnStartConfig({
     mcpServers,
     debug: turnStartConfig.debug,
     authenticationProfile,
-    sessionMeta
+    sessionMeta,
+    instructionMapping
   });
   if (current.configurationFingerprint !== turnStartConfig.configurationFingerprint) {
     throw new Error(
@@ -2034,6 +2067,7 @@ function validateACPColdSessionConfiguration({
   permissionMode,
   authenticationProfile,
   sessionMeta,
+  instructionMapping,
   builtinTools,
   permissionModeMapping,
   mcpServers,
@@ -2048,7 +2082,8 @@ function validateACPColdSessionConfiguration({
     mcpServers,
     debug,
     authenticationProfile,
-    sessionMeta
+    sessionMeta,
+    instructionMapping
   });
   if (current.configurationFingerprint !== coldSession.configurationFingerprint || coldSession.permissionMode !== permissionMode || coldSession.modelId !== modelId) {
     throw new Error(
@@ -2095,7 +2130,7 @@ function deserializeBridgeError({
 }
 
 // src/version.ts
-var VERSION = true ? "1.0.2" : "0.0.0-test";
+var VERSION = true ? "1.0.3" : "0.0.0-test";
 
 // src/acp-harness.ts
 var ACP_CLIENT_APP = {