ankka 0.10.0 → 0.12.0

package/README.md

@@ -25,6 +25,7 @@ npm run typecheck                  # tsc --noEmit over src, test, examples
 npm test                           # the fast tests, no Docker
 npm run test:slow                  # the Docker-backed tests (needs the ankka-sidecar image)
 npm run conformance                # the platform's conformance suite against this SDK's reference service
+ANKKA_CONFORMANCE_SECRETS=secret-manager npm run conformance   # its secret cases on the Secret Manager backend
 npm run build                      # emit dist/, what the package ships
 ```
 

package/dist/_proto/ankka/protocol/v1/agent_pb.d.ts

@@ -185,6 +185,9 @@ export type AgentPlan_Memory = (typeof AgentPlan_Memory)[keyof typeof AgentPlan_
  */
 export declare const AgentPlan_MemorySchema: GenEnum<AgentPlan_Memory>;
 /**
+ * `metadata` (1.3): the trace the tool runs in and the agent's handler as the caller of whatever
+ * the tool calls, for the process to forward on those calls.
+ *
  * @generated from message ankka.protocol.v1.ToolRequest
  */
 export type ToolRequest = Message<"ankka.protocol.v1.ToolRequest"> & {
@@ -204,6 +207,10 @@ export type ToolRequest = Message<"ankka.protocol.v1.ToolRequest"> & {
      * @generated from field: string arguments_json = 4;
      */
     argumentsJson: string;
+    /**
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 5;
+     */
+    metadata?: Metadata | undefined;
 };
 /**
  * Describes the message ankka.protocol.v1.ToolRequest.
@@ -263,6 +270,18 @@ export type GuardrailRequest = Message<"ankka.protocol.v1.GuardrailRequest"> & {
      * @generated from field: string text = 5;
      */
     text: string;
+    /**
+     * protocol 1.3: the trace, and the handler whose call this check is
+     *
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 6;
+     */
+    metadata?: Metadata | undefined;
+    /**
+     * protocol 1.11: with RESULT, the MCP tool whose result this is
+     *
+     * @generated from field: optional string tool = 7;
+     */
+    tool?: string | undefined;
 };
 /**
  * Describes the message ankka.protocol.v1.GuardrailRequest.
@@ -270,6 +289,9 @@ export type GuardrailRequest = Message<"ankka.protocol.v1.GuardrailRequest"> & {
  */
 export declare const GuardrailRequestSchema: GenMessage<GuardrailRequest>;
 /**
+ * RESULT (1.11): what an MCP server's tool answered, checked by a result guardrail before the
+ * model is told it.
+ *
  * @generated from enum ankka.protocol.v1.GuardrailRequest.Stage
  */
 export declare const GuardrailRequest_Stage: {
@@ -281,8 +303,15 @@ export declare const GuardrailRequest_Stage: {
      * @generated from enum value: OUTPUT = 1;
      */
     readonly OUTPUT: 1;
+    /**
+     * @generated from enum value: RESULT = 2;
+     */
+    readonly RESULT: 2;
 };
 /**
+ * RESULT (1.11): what an MCP server's tool answered, checked by a result guardrail before the
+ * model is told it.
+ *
  * @generated from enum ankka.protocol.v1.GuardrailRequest.Stage
  */
 export type GuardrailRequest_Stage = (typeof GuardrailRequest_Stage)[keyof typeof GuardrailRequest_Stage] | UnknownEnum;
@@ -345,6 +374,12 @@ export type TaskResultRequest = Message<"ankka.protocol.v1.TaskResultRequest"> &
      * @generated from field: string result_json = 4;
      */
     resultJson: string;
+    /**
+     * protocol 1.3: the trace, and the handler whose call this check is
+     *
+     * @generated from field: ankka.protocol.v1.Metadata metadata = 5;
+     */
+    metadata?: Metadata | undefined;
 };
 /**
  * Describes the message ankka.protocol.v1.TaskResultRequest.

package/dist/_proto/ankka/protocol/v1/agent_pb.js

@@ -4,7 +4,7 @@ import { file_ankka_protocol_v1_payload } from "./payload_pb.js";
 /**
  * Describes the file ankka/protocol/v1/agent.proto.
  */
-export const file_ankka_protocol_v1_agent = /*@__PURE__*/ fileDesc("Ch1hbmtrYS9wcm90b2NvbC92MS9hZ2VudC5wcm90bxIRYW5ra2EucHJvdG9jb2wudjEioQEKC1BsYW5SZXF1ZXN0EhQKDGNvbXBvbmVudF9pZBgBIAEoCRISCgpzZXNzaW9uX2lkGAIgASgJEgwKBG5hbWUYAyABKAkSKwoHcGF5bG9hZBgEIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWQSLQoIbWV0YWRhdGEYBSABKAsyGy5hbmtrYS5wcm90b2NvbC52MS5NZXRhZGF0YSJzCglQbGFuUmVwbHkSLAoEcGxhbhgBIAEoCzIcLmFua2thLnByb3RvY29sLnYxLkFnZW50UGxhbkgAEi0KB2ZhaWx1cmUYAiABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSABCCQoHbWVzc2FnZSKSBAoJQWdlbnRQbGFuEhIKBW1vZGVsGAEgASgJSACIAQESEwoGc3lzdGVtGAIgASgJSAGIAQESEQoEdXNlchgDIAEoCUgCiAEBEg8KB2NvbnRleHQYBCADKAkSMwoGbWVtb3J5GAUgASgOMiMuYW5ra2EucHJvdG9jb2wudjEuQWdlbnRQbGFuLk1lbW9yeRINCgV0b29scxgGIAMoCRJCCg5yZXNwb25zZV9zaGFwZRgHIAEoCzIqLmFua2thLnByb3RvY29sLnYxLkFnZW50UGxhbi5SZXNwb25zZVNoYXBlEhIKCmd1YXJkcmFpbHMYCCADKAkSLgoHZmFpbHVyZRgJIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVycm9ySAOIAQEaoAEKDVJlc3BvbnNlU2hhcGUSKAoEdGV4dBgBIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVtcHR5SAASPwoEanNvbhgCIAEoCzIvLmFua2thLnByb3RvY29sLnYxLkFnZW50UGxhbi5SZXNwb25zZVNoYXBlLkpzb25IABobCgRKc29uEhMKC3NjaGVtYV9oaW50GAEgASgJQgcKBXNoYXBlIh8KBk1lbW9yeRILCgdTRVNTSU9OEAASCAoETk9ORRABQggKBl9tb2RlbEIJCgdfc3lzdGVtQgcKBV91c2VyQgoKCF9mYWlsdXJlIl0KC1Rvb2xSZXF1ZXN0EhQKDGNvbXBvbmVudF9pZBgBIAEoCRISCgpzZXNzaW9uX2lkGAIgASgJEgwKBHRvb2wYAyABKAkSFgoOYXJndW1lbnRzX2pzb24YBCABKAkiNQoKVG9vbFJlc3VsdBIMCgJvaxgBIAEoCUgAEg8KBWVycm9yGAIgASgJSABCCAoGcmVzdWx0IrcBChBHdWFyZHJhaWxSZXF1ZXN0EhQKDGNvbXBvbmVudF9pZBgBIAEoCRISCgpzZXNzaW9uX2lkGAIgASgJEhEKCWd1YXJkcmFpbBgDIAEoCRI4CgVzdGFnZRgEIAEoDjIpLmFua2thLnByb3RvY29sLnYxLkd1YXJkcmFpbFJlcXVlc3QuU3RhZ2USDAoEdGV4dBgFIAEoCSIeCgVTdGFnZRIJCgVJTlBVVBAAEgoKBk9VVFBVVBABIlYKD0d1YXJkcmFpbFJlc3VsdBIoCgRwYXNzGAEgASgLMhguYW5ra2EucHJvdG9jb2wudjEuRW1wdHlIABIPCgVibG9jaxgCIAEoCUgAQggKBnJlc3VsdCJiChFUYXNrUmVzdWx0UmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSDwoHdGFza19pZBgCIAEoCRIRCgl0YXNrX3R5cGUYAyABKAkSEwoLcmVzdWx0X2pzb24YBCABKAkizAEKEVRhc2tSZXN1bHRWZXJkaWN0EioKBmFjY2VwdBgBIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVtcHR5SAASEwoJbWFsZm9ybWVkGAIgASgJSAASQAoGcmVqZWN0GAMgASgLMi4uYW5ra2EucHJvdG9jb2wudjEuVGFza1Jlc3VsdFZlcmRpY3QuUmVqZWN0aW9uSAAaKQoJUmVqZWN0aW9uEgwKBHJ1bGUYASABKAkSDgoGcmVhc29uGAIgASgJQgkKB3ZlcmRpY3Qy1AIKBUFnZW50EkQKBFBsYW4SHi5hbmtrYS5wcm90b2NvbC52MS5QbGFuUmVxdWVzdBocLmFua2thLnByb3RvY29sLnYxLlBsYW5SZXBseRJLCgpJbnZva2VUb29sEh4uYW5ra2EucHJvdG9jb2wudjEuVG9vbFJlcXVlc3QaHS5hbmtrYS5wcm90b2NvbC52MS5Ub29sUmVzdWx0ElkKDkNoZWNrR3VhcmRyYWlsEiMuYW5ra2EucHJvdG9jb2wudjEuR3VhcmRyYWlsUmVxdWVzdBoiLmFua2thLnByb3RvY29sLnYxLkd1YXJkcmFpbFJlc3VsdBJdCg9DaGVja1Rhc2tSZXN1bHQSJC5hbmtrYS5wcm90b2NvbC52MS5UYXNrUmVzdWx0UmVxdWVzdBokLmFua2thLnByb3RvY29sLnYxLlRhc2tSZXN1bHRWZXJkaWN0YgZwcm90bzM", [file_ankka_protocol_v1_payload]);
+export const file_ankka_protocol_v1_agent = /*@__PURE__*/ fileDesc("Ch1hbmtrYS9wcm90b2NvbC92MS9hZ2VudC5wcm90bxIRYW5ra2EucHJvdG9jb2wudjEioQEKC1BsYW5SZXF1ZXN0EhQKDGNvbXBvbmVudF9pZBgBIAEoCRISCgpzZXNzaW9uX2lkGAIgASgJEgwKBG5hbWUYAyABKAkSKwoHcGF5bG9hZBgEIAEoCzIaLmFua2thLnByb3RvY29sLnYxLlBheWxvYWQSLQoIbWV0YWRhdGEYBSABKAsyGy5hbmtrYS5wcm90b2NvbC52MS5NZXRhZGF0YSJzCglQbGFuUmVwbHkSLAoEcGxhbhgBIAEoCzIcLmFua2thLnByb3RvY29sLnYxLkFnZW50UGxhbkgAEi0KB2ZhaWx1cmUYAiABKAsyGi5hbmtrYS5wcm90b2NvbC52MS5GYWlsdXJlSABCCQoHbWVzc2FnZSKSBAoJQWdlbnRQbGFuEhIKBW1vZGVsGAEgASgJSACIAQESEwoGc3lzdGVtGAIgASgJSAGIAQESEQoEdXNlchgDIAEoCUgCiAEBEg8KB2NvbnRleHQYBCADKAkSMwoGbWVtb3J5GAUgASgOMiMuYW5ra2EucHJvdG9jb2wudjEuQWdlbnRQbGFuLk1lbW9yeRINCgV0b29scxgGIAMoCRJCCg5yZXNwb25zZV9zaGFwZRgHIAEoCzIqLmFua2thLnByb3RvY29sLnYxLkFnZW50UGxhbi5SZXNwb25zZVNoYXBlEhIKCmd1YXJkcmFpbHMYCCADKAkSLgoHZmFpbHVyZRgJIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVycm9ySAOIAQEaoAEKDVJlc3BvbnNlU2hhcGUSKAoEdGV4dBgBIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVtcHR5SAASPwoEanNvbhgCIAEoCzIvLmFua2thLnByb3RvY29sLnYxLkFnZW50UGxhbi5SZXNwb25zZVNoYXBlLkpzb25IABobCgRKc29uEhMKC3NjaGVtYV9oaW50GAEgASgJQgcKBXNoYXBlIh8KBk1lbW9yeRILCgdTRVNTSU9OEAASCAoETk9ORRABQggKBl9tb2RlbEIJCgdfc3lzdGVtQgcKBV91c2VyQgoKCF9mYWlsdXJlIowBCgtUb29sUmVxdWVzdBIUCgxjb21wb25lbnRfaWQYASABKAkSEgoKc2Vzc2lvbl9pZBgCIAEoCRIMCgR0b29sGAMgASgJEhYKDmFyZ3VtZW50c19qc29uGAQgASgJEi0KCG1ldGFkYXRhGAUgASgLMhsuYW5ra2EucHJvdG9jb2wudjEuTWV0YWRhdGEiNQoKVG9vbFJlc3VsdBIMCgJvaxgBIAEoCUgAEg8KBWVycm9yGAIgASgJSABCCAoGcmVzdWx0Io4CChBHdWFyZHJhaWxSZXF1ZXN0EhQKDGNvbXBvbmVudF9pZBgBIAEoCRISCgpzZXNzaW9uX2lkGAIgASgJEhEKCWd1YXJkcmFpbBgDIAEoCRI4CgVzdGFnZRgEIAEoDjIpLmFua2thLnByb3RvY29sLnYxLkd1YXJkcmFpbFJlcXVlc3QuU3RhZ2USDAoEdGV4dBgFIAEoCRItCghtZXRhZGF0YRgGIAEoCzIbLmFua2thLnByb3RvY29sLnYxLk1ldGFkYXRhEhEKBHRvb2wYByABKAlIAIgBASIqCgVTdGFnZRIJCgVJTlBVVBAAEgoKBk9VVFBVVBABEgoKBlJFU1VMVBACQgcKBV90b29sIlYKD0d1YXJkcmFpbFJlc3VsdBIoCgRwYXNzGAEgASgLMhguYW5ra2EucHJvdG9jb2wudjEuRW1wdHlIABIPCgVibG9jaxgCIAEoCUgAQggKBnJlc3VsdCKRAQoRVGFza1Jlc3VsdFJlcXVlc3QSFAoMY29tcG9uZW50X2lkGAEgASgJEg8KB3Rhc2tfaWQYAiABKAkSEQoJdGFza190eXBlGAMgASgJEhMKC3Jlc3VsdF9qc29uGAQgASgJEi0KCG1ldGFkYXRhGAUgASgLMhsuYW5ra2EucHJvdG9jb2wudjEuTWV0YWRhdGEizAEKEVRhc2tSZXN1bHRWZXJkaWN0EioKBmFjY2VwdBgBIAEoCzIYLmFua2thLnByb3RvY29sLnYxLkVtcHR5SAASEwoJbWFsZm9ybWVkGAIgASgJSAASQAoGcmVqZWN0GAMgASgLMi4uYW5ra2EucHJvdG9jb2wudjEuVGFza1Jlc3VsdFZlcmRpY3QuUmVqZWN0aW9uSAAaKQoJUmVqZWN0aW9uEgwKBHJ1bGUYASABKAkSDgoGcmVhc29uGAIgASgJQgkKB3ZlcmRpY3Qy1AIKBUFnZW50EkQKBFBsYW4SHi5hbmtrYS5wcm90b2NvbC52MS5QbGFuUmVxdWVzdBocLmFua2thLnByb3RvY29sLnYxLlBsYW5SZXBseRJLCgpJbnZva2VUb29sEh4uYW5ra2EucHJvdG9jb2wudjEuVG9vbFJlcXVlc3QaHS5hbmtrYS5wcm90b2NvbC52MS5Ub29sUmVzdWx0ElkKDkNoZWNrR3VhcmRyYWlsEiMuYW5ra2EucHJvdG9jb2wudjEuR3VhcmRyYWlsUmVxdWVzdBoiLmFua2thLnByb3RvY29sLnYxLkd1YXJkcmFpbFJlc3VsdBJdCg9DaGVja1Rhc2tSZXN1bHQSJC5hbmtrYS5wcm90b2NvbC52MS5UYXNrUmVzdWx0UmVxdWVzdBokLmFua2thLnByb3RvY29sLnYxLlRhc2tSZXN1bHRWZXJkaWN0YgZwcm90bzM", [file_ankka_protocol_v1_payload]);
 /**
  * Describes the message ankka.protocol.v1.PlanRequest.
  * Use `create(PlanRequestSchema)` to create a new message.
@@ -63,6 +63,9 @@ export const ToolResultSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1
  */
 export const GuardrailRequestSchema = /*@__PURE__*/ messageDesc(file_ankka_protocol_v1_agent, 5);
 /**
+ * RESULT (1.11): what an MCP server's tool answered, checked by a result guardrail before the
+ * model is told it.
+ *
  * @generated from enum ankka.protocol.v1.GuardrailRequest.Stage
  */
 export const GuardrailRequest_Stage = {
@@ -74,6 +77,10 @@ export const GuardrailRequest_Stage = {
      * @generated from enum value: OUTPUT = 1;
      */
     OUTPUT: 1,
+    /**
+     * @generated from enum value: RESULT = 2;
+     */
+    RESULT: 2,
 };
 /**
  * Describes the enum ankka.protocol.v1.GuardrailRequest.Stage.