@stigmer/protos 3.0.8-dev.20260613074252 → 3.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -246,9 +246,102 @@ export type ToolCall = Message<"ai.stigmer.agentic.agentexecution.v1.ToolCall">
246
246
  * @generated from field: ai.stigmer.agentic.agentexecution.v1.ToolKind tool_kind = 20;
247
247
  */
248
248
  toolKind: ToolKind;
249
+ /**
250
+ * ─────────────────────────────────────────────────────────────────────────────
251
+ * Offloaded Output (large tool results)
252
+ *
253
+ * When a tool's output exceeds a size threshold, the runner spills the full
254
+ * bytes to artifact storage and records a reference here instead of inlining
255
+ * megabytes into `result` on every status update. Without this, a single
256
+ * large result (e.g. a base64 screenshot or a multi-MB accessibility tree)
257
+ * pushes AgentExecutionStatus past the gRPC message-size limit, so status
258
+ * persistence fails silently and the live UI freezes mid-execution.
259
+ *
260
+ * When set, `result` holds only a short human-readable head/preview (so
261
+ * consumers that read `result` still render something sensible) and
262
+ * output_ref points at the full content. Empty for the overwhelming majority
263
+ * of tool calls — only populated when output crosses the offload threshold.
264
+ * See ToolCallOutputRef.
265
+ *
266
+ * Field 21: appended after tool_kind (20), the prior maximum.
267
+ *
268
+ * @generated from field: ai.stigmer.agentic.agentexecution.v1.ToolCallOutputRef output_ref = 21;
269
+ */
270
+ outputRef?: ToolCallOutputRef;
249
271
  };
250
272
  /**
251
273
  * Describes the message ai.stigmer.agentic.agentexecution.v1.ToolCall.
252
274
  * Use `create(ToolCallSchema)` to create a new message.
253
275
  */
254
276
  export declare const ToolCallSchema: GenMessage<ToolCall>;
277
+ /**
278
+ * ToolCallOutputRef points to a tool call's full output after the runner
279
+ * offloaded it to artifact storage to keep AgentExecutionStatus under the gRPC
280
+ * message-size limit.
281
+ *
282
+ * This is deliberately distinct from ExecutionArtifact (a file the agent
283
+ * publishes for the user to download via publish_artifact): an output ref is
284
+ * internal spillover of a tool's result, not a user-facing deliverable. The
285
+ * bytes live in artifact storage (R2 in the cloud, locally served in dev);
286
+ * only this reference is persisted in the execution status.
287
+ *
288
+ * @since Durable Executions (tool-output offload)
289
+ *
290
+ * @generated from message ai.stigmer.agentic.agentexecution.v1.ToolCallOutputRef
291
+ */
292
+ export type ToolCallOutputRef = Message<"ai.stigmer.agentic.agentexecution.v1.ToolCallOutputRef"> & {
293
+ /**
294
+ * Storage location of the full output bytes.
295
+ * Format: "artifacts/{execution_id}/toolcalls/{tool_call_id}.{ext}"
296
+ *
297
+ * @generated from field: string storage_key = 1;
298
+ */
299
+ storageKey: string;
300
+ /**
301
+ * URL for fetching the full output — pre-signed in the cloud, locally served
302
+ * in dev. May be refreshed via the artifact download endpoint if expired.
303
+ *
304
+ * @generated from field: string download_url = 2;
305
+ */
306
+ downloadUrl: string;
307
+ /**
308
+ * Size in bytes of the full (original, pre-truncation) output.
309
+ *
310
+ * @generated from field: int64 size_bytes = 3;
311
+ */
312
+ sizeBytes: bigint;
313
+ /**
314
+ * SHA-256 hex digest of the full output bytes. Lets the runner dedupe
315
+ * uploads (skip re-uploading identical content across repeated persists) and
316
+ * lets clients invalidate caches when content changes under a stable key.
317
+ *
318
+ * @generated from field: string content_hash = 4;
319
+ */
320
+ contentHash: string;
321
+ /**
322
+ * MIME type of the offloaded content.
323
+ * Examples: "image/png", "text/plain", "application/json".
324
+ *
325
+ * @generated from field: string mime_type = 5;
326
+ */
327
+ mimeType: string;
328
+ /**
329
+ * True when the offloaded content is an image the UI should render inline
330
+ * (e.g. a screenshot from a computer-use MCP server).
331
+ *
332
+ * @generated from field: bool is_image = 6;
333
+ */
334
+ isImage: boolean;
335
+ /**
336
+ * Short head of the original text content, kept inline for an at-a-glance
337
+ * preview without fetching the full artifact. Empty for image content.
338
+ *
339
+ * @generated from field: string truncated_preview = 7;
340
+ */
341
+ truncatedPreview: string;
342
+ };
343
+ /**
344
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.ToolCallOutputRef.
345
+ * Use `create(ToolCallOutputRefSchema)` to create a new message.
346
+ */
347
+ export declare const ToolCallOutputRefSchema: GenMessage<ToolCallOutputRef>;
@@ -8,7 +8,7 @@ import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
8
8
  /**
9
9
  * Describes the file ai/stigmer/agentic/agentexecution/v1/message.proto.
10
10
  */
11
- export const file_ai_stigmer_agentic_agentexecution_v1_message = /*@__PURE__*/ fileDesc("CjJhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvbWVzc2FnZS5wcm90bxIkYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxIoICCgxBZ2VudE1lc3NhZ2USSQoEdHlwZRgBIAEoDjIxLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5NZXNzYWdlVHlwZUIIukgFggECEAESDwoHY29udGVudBgCIAEoCRIRCgl0aW1lc3RhbXAYAyABKAkSQgoKdG9vbF9jYWxscxgEIAMoCzIuLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Ub29sQ2FsbBIpCghtZXRhZGF0YRgFIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QSFAoMaXNfc3RyZWFtaW5nGAYgASgIIpoFCghUb29sQ2FsbBIKCgJpZBgBIAEoCRIMCgRuYW1lGAIgASgJEiUKBGFyZ3MYAyABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0Eg4KBnJlc3VsdBgEIAEoCRJOCgZzdGF0dXMYBSABKA4yNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuVG9vbENhbGxTdGF0dXNCCLpIBYIBAhABEhIKCnN0YXJ0ZWRfYXQYByABKAkSFAoMY29tcGxldGVkX2F0GAggASgJEg0KBWVycm9yGAkgASgJEhkKEXJlcXVpcmVzX2FwcHJvdmFsGAogASgIEhgKEGFwcHJvdmFsX21lc3NhZ2UYCyABKAkSHQoVYXBwcm92YWxfcmVxdWVzdGVkX2F0GAwgASgJEhsKE2FwcHJvdmFsX2RlY2lkZWRfYXQYDSABKAkSEwoLYXBwcm92ZWRfYnkYDiABKAkSTQoPYXBwcm92YWxfYWN0aW9uGA8gASgOMjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFwcHJvdmFsQWN0aW9uEhQKDGlzX3N0cmVhbWluZxgQIAEoCBJXChBzdHJlYW1pbmdfc291cmNlGBMgASgOMj0uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlRvb2xDYWxsU3RyZWFtaW5nU291cmNlEhcKD21jcF9zZXJ2ZXJfc2x1ZxgRIAEoCRIUCgxhcmdzX3ByZXZpZXcYEiABKAkSQQoJdG9vbF9raW5kGBQgASgOMi4uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlRvb2xLaW5kYgZwcm90bzM", [file_ai_stigmer_agentic_agentexecution_v1_enum, file_buf_validate_validate, file_google_protobuf_struct]);
11
+ export const file_ai_stigmer_agentic_agentexecution_v1_message = /*@__PURE__*/ fileDesc("CjJhaS9zdGlnbWVyL2FnZW50aWMvYWdlbnRleGVjdXRpb24vdjEvbWVzc2FnZS5wcm90bxIkYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxIoICCgxBZ2VudE1lc3NhZ2USSQoEdHlwZRgBIAEoDjIxLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5NZXNzYWdlVHlwZUIIukgFggECEAESDwoHY29udGVudBgCIAEoCRIRCgl0aW1lc3RhbXAYAyABKAkSQgoKdG9vbF9jYWxscxgEIAMoCzIuLmFpLnN0aWdtZXIuYWdlbnRpYy5hZ2VudGV4ZWN1dGlvbi52MS5Ub29sQ2FsbBIpCghtZXRhZGF0YRgFIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3QSFAoMaXNfc3RyZWFtaW5nGAYgASgIIucFCghUb29sQ2FsbBIKCgJpZBgBIAEoCRIMCgRuYW1lGAIgASgJEiUKBGFyZ3MYAyABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0Eg4KBnJlc3VsdBgEIAEoCRJOCgZzdGF0dXMYBSABKA4yNC5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuVG9vbENhbGxTdGF0dXNCCLpIBYIBAhABEhIKCnN0YXJ0ZWRfYXQYByABKAkSFAoMY29tcGxldGVkX2F0GAggASgJEg0KBWVycm9yGAkgASgJEhkKEXJlcXVpcmVzX2FwcHJvdmFsGAogASgIEhgKEGFwcHJvdmFsX21lc3NhZ2UYCyABKAkSHQoVYXBwcm92YWxfcmVxdWVzdGVkX2F0GAwgASgJEhsKE2FwcHJvdmFsX2RlY2lkZWRfYXQYDSABKAkSEwoLYXBwcm92ZWRfYnkYDiABKAkSTQoPYXBwcm92YWxfYWN0aW9uGA8gASgOMjQuYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLkFwcHJvdmFsQWN0aW9uEhQKDGlzX3N0cmVhbWluZxgQIAEoCBJXChBzdHJlYW1pbmdfc291cmNlGBMgASgOMj0uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlRvb2xDYWxsU3RyZWFtaW5nU291cmNlEhcKD21jcF9zZXJ2ZXJfc2x1ZxgRIAEoCRIUCgxhcmdzX3ByZXZpZXcYEiABKAkSQQoJdG9vbF9raW5kGBQgASgOMi4uYWkuc3RpZ21lci5hZ2VudGljLmFnZW50ZXhlY3V0aW9uLnYxLlRvb2xLaW5kEksKCm91dHB1dF9yZWYYFSABKAsyNy5haS5zdGlnbWVyLmFnZW50aWMuYWdlbnRleGVjdXRpb24udjEuVG9vbENhbGxPdXRwdXRSZWYiqAEKEVRvb2xDYWxsT3V0cHV0UmVmEhMKC3N0b3JhZ2Vfa2V5GAEgASgJEhQKDGRvd25sb2FkX3VybBgCIAEoCRISCgpzaXplX2J5dGVzGAMgASgDEhQKDGNvbnRlbnRfaGFzaBgEIAEoCRIRCgltaW1lX3R5cGUYBSABKAkSEAoIaXNfaW1hZ2UYBiABKAgSGQoRdHJ1bmNhdGVkX3ByZXZpZXcYByABKAliBnByb3RvMw", [file_ai_stigmer_agentic_agentexecution_v1_enum, file_buf_validate_validate, file_google_protobuf_struct]);
12
12
  /**
13
13
  * Describes the message ai.stigmer.agentic.agentexecution.v1.AgentMessage.
14
14
  * Use `create(AgentMessageSchema)` to create a new message.
@@ -19,4 +19,9 @@ export const AgentMessageSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agen
19
19
  * Use `create(ToolCallSchema)` to create a new message.
20
20
  */
21
21
  export const ToolCallSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_message, 1);
22
+ /**
23
+ * Describes the message ai.stigmer.agentic.agentexecution.v1.ToolCallOutputRef.
24
+ * Use `create(ToolCallOutputRefSchema)` to create a new message.
25
+ */
26
+ export const ToolCallOutputRefSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_agentic_agentexecution_v1_message, 2);
22
27
  //# sourceMappingURL=message_pb.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"message_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/message_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wIAAwI;AACxI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,8CAA8C,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,61CAA61C,EAAE,CAAC,8CAA8C,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAuDr9C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC;AAmNpE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,aAAa,CAC/D,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"message_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/agentic/agentexecution/v1/message_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wIAAwI;AACxI,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,8CAA8C,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;GAEG;AACH,MAAM,CAAC,MAAM,iDAAiD,GAAY,aAAa,CACrF,QAAQ,CAAC,wqDAAwqD,EAAE,CAAC,8CAA8C,EAAE,0BAA0B,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAuDhyD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC;AA0OpE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,aAAa,CAC/D,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC;AA2EpE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,iDAAiD,EAAE,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stigmer/protos",
3
- "version": "3.0.8-dev.20260613074252",
3
+ "version": "3.0.8",
4
4
  "description": "Generated TypeScript protobuf stubs for Stigmer APIs",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",