@sjawhar/pi-legion-envoy 0.37.0 → 0.38.0

package/dist/envoy.js

@@ -29650,7 +29650,9 @@ function date4(params) {
 config(en_default());
 // ../contracts/src/dispatch-api.ts
 var DispatchEventSchema = object({
-  issue_key: string2(),
+  issue_key: string2().nullable(),
+  artifact_id: string2().nullish(),
+  project: string2().optional(),
   type: string2(),
   actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
   payload: object({}).passthrough()
@@ -29668,7 +29670,7 @@ var ArtifactVersionEventPayloadSchema = object({
   version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
   diff: string2().optional()
 });
-var AskEventPayloadSchema = object({
+var askEventPayloadFields = {
   opened_event_id: number2().int().positive(),
   question: string2().optional(),
   options: array(object({ label: string2().optional() })).nullish(),
@@ -29679,6 +29681,23 @@ var AskEventPayloadSchema = object({
     actor: object({ kind: string2().optional(), id: string2().optional() }).passthrough().optional(),
     at: string2().optional()
   }).nullish()
+};
+var AskEventPayloadSchema = intersection(object(askEventPayloadFields), object({
+  previous: never().optional(),
+  edited_by: never().optional()
+}));
+var AskEditedEventPayloadSchema = object({
+  ...askEventPayloadFields,
+  multiple: boolean2(),
+  urgency: string2(),
+  edited_at: string2().nullish(),
+  previous: object({
+    question: string2(),
+    options: array(object({ label: string2().optional() })),
+    multiple: boolean2(),
+    urgency: string2()
+  }),
+  edited_by: object({ kind: string2(), id: string2() }).passthrough()
 });
 var CommentEventPayloadSchema = object({
   artifact_name: string2().optional(),
@@ -30911,6 +30930,7 @@ var DISPATCH_PAYLOAD_SCHEMAS = {
   "artifact.created": ArtifactCreatedEventPayloadSchema,
   "artifact.version": ArtifactVersionEventPayloadSchema,
   "ask.opened": AskEventPayloadSchema,
+  "ask.edited": AskEditedEventPayloadSchema,
   "ask.answered": AskEventPayloadSchema,
   "ask.resolved": AskEventPayloadSchema,
   "comment.created": CommentEventPayloadSchema,
@@ -30920,6 +30940,18 @@ var DISPATCH_PAYLOAD_SCHEMAS = {
   "message.created": MessageEventPayloadSchema,
   "child.status": ChildStatusEventPayloadSchema
 };
+var DISPATCH_DOCUMENT_TOPIC_PREFIX = "notifications.dispatch.document.";
+function dispatchOwner(event, topic) {
+  if (event.issue_key !== null)
+    return event.issue_key;
+  if (topic?.startsWith(DISPATCH_DOCUMENT_TOPIC_PREFIX) === true) {
+    const [project, slug] = topic.slice(DISPATCH_DOCUMENT_TOPIC_PREFIX.length).split(".", 3);
+    if (project !== undefined && project !== "" && slug !== undefined && slug !== "") {
+      return `${project}/${slug}`;
+    }
+  }
+  return event.artifact_id ?? "unknown";
+}
 function dispatchPayload(event) {
   const schema = DISPATCH_PAYLOAD_SCHEMAS[event.type];
   if (schema === undefined)
@@ -30998,7 +31030,8 @@ function renderInbound(raw, sessionID, subject) {
         }
         askQuestion = dispatchAskQuestion(frame.event);
         dispatchEvent = {
-          issue_key: frame.event.issue_key,
+          owner: dispatchOwner(frame.event, subject ?? envelope.topic),
+          ...frame.event.issue_key === null ? frame.event.artifact_id === undefined || frame.event.artifact_id === null ? {} : { artifact_id: frame.event.artifact_id } : { issue_key: frame.event.issue_key },
           type: frame.event.type,
           actor: frame.event.actor,
           payload: dispatchPayload(frame.event)
@@ -31458,6 +31491,23 @@ var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
 var bareIssueNumberPattern = /^[1-9][0-9]*$/;
 var issueFreeTools = new Set(["dispatch_issue", "dispatch_resolve_ask", "dispatch_search"]);
+async function askResultDetails(client, ask) {
+  if (ask.issue_key !== null) {
+    return {
+      issue: ask.issue_key,
+      topic: dispatchIssueSubject(ask.issue_key, ">"),
+      ask: ask.id
+    };
+  }
+  if (ask.artifact_id === undefined || ask.artifact_id === null) {
+    throw new Error("document ask is missing its artifact ID");
+  }
+  const artifact = await client.getArtifact(ask.artifact_id);
+  return {
+    topic: `notifications.dispatch.document.${artifact.project}.${artifact.slug}.>`,
+    ask: ask.id
+  };
+}
 function canonicalExternalIssueRef(value) {
   const match = value.trim().match(externalIssueRefPattern);
   return match ? `${canonicalRepo(match[1] ?? "", match[2] ?? "")}#${match[3]}` : value;
@@ -31773,11 +31823,7 @@ async function executeDispatchTool(input) {
         throw new Error("resolved ask is missing its resolution");
       return {
         text: `${kind === "retracted" ? "Retracted" : "Resolved"} ask ${ask.id}: ${ask.resolution.reason}`,
-        details: {
-          issue: ask.issue_key,
-          topic: dispatchIssueSubject(ask.issue_key, ">"),
-          ask: ask.id
-        }
+        details: await askResultDetails(client, ask)
       };
     }
     case "dispatch_ask": {
@@ -31797,11 +31843,7 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Opened ask ${ask.id}: ${ask.question}`,
-        details: {
-          issue: ask.issue_key,
-          topic: dispatchIssueSubject(ask.issue_key, ">"),
-          ask: ask.id
-        }
+        details: await askResultDetails(client, ask)
       };
     }
     case "dispatch_comment": {
@@ -31926,7 +31968,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         const askRead = await client.getAsk(issueArguments.ref.id);
         return {
           text: askSummary(askRead),
-          details: { issue: askRead.ask.issue_key }
+          details: { issue: issueArguments.ref.issue }
         };
       }
       if (issueArguments.ref?.kind === "comment") {

package/dist/legion.js

@@ -29648,7 +29648,9 @@ function date4(params) {
 config(en_default());
 // ../contracts/src/dispatch-api.ts
 var DispatchEventSchema = object({
-  issue_key: string2(),
+  issue_key: string2().nullable(),
+  artifact_id: string2().nullish(),
+  project: string2().optional(),
   type: string2(),
   actor: object({ kind: string2(), id: string2().optional() }).passthrough(),
   payload: object({}).passthrough()
@@ -29666,7 +29668,7 @@ var ArtifactVersionEventPayloadSchema = object({
   version: object({ number: number2().optional(), summary: string2().nullish() }).optional(),
   diff: string2().optional()
 });
-var AskEventPayloadSchema = object({
+var askEventPayloadFields = {
   opened_event_id: number2().int().positive(),
   question: string2().optional(),
   options: array(object({ label: string2().optional() })).nullish(),
@@ -29677,6 +29679,23 @@ var AskEventPayloadSchema = object({
     actor: object({ kind: string2().optional(), id: string2().optional() }).passthrough().optional(),
     at: string2().optional()
   }).nullish()
+};
+var AskEventPayloadSchema = intersection(object(askEventPayloadFields), object({
+  previous: never().optional(),
+  edited_by: never().optional()
+}));
+var AskEditedEventPayloadSchema = object({
+  ...askEventPayloadFields,
+  multiple: boolean2(),
+  urgency: string2(),
+  edited_at: string2().nullish(),
+  previous: object({
+    question: string2(),
+    options: array(object({ label: string2().optional() })),
+    multiple: boolean2(),
+    urgency: string2()
+  }),
+  edited_by: object({ kind: string2(), id: string2() }).passthrough()
 });
 var CommentEventPayloadSchema = object({
   artifact_name: string2().optional(),
@@ -31357,6 +31376,7 @@ var DISPATCH_PAYLOAD_SCHEMAS = {
   "artifact.created": ArtifactCreatedEventPayloadSchema,
   "artifact.version": ArtifactVersionEventPayloadSchema,
   "ask.opened": AskEventPayloadSchema,
+  "ask.edited": AskEditedEventPayloadSchema,
   "ask.answered": AskEventPayloadSchema,
   "ask.resolved": AskEventPayloadSchema,
   "comment.created": CommentEventPayloadSchema,
@@ -31366,6 +31386,18 @@ var DISPATCH_PAYLOAD_SCHEMAS = {
   "message.created": MessageEventPayloadSchema,
   "child.status": ChildStatusEventPayloadSchema
 };
+var DISPATCH_DOCUMENT_TOPIC_PREFIX = "notifications.dispatch.document.";
+function dispatchOwner(event, topic) {
+  if (event.issue_key !== null)
+    return event.issue_key;
+  if (topic?.startsWith(DISPATCH_DOCUMENT_TOPIC_PREFIX) === true) {
+    const [project, slug] = topic.slice(DISPATCH_DOCUMENT_TOPIC_PREFIX.length).split(".", 3);
+    if (project !== undefined && project !== "" && slug !== undefined && slug !== "") {
+      return `${project}/${slug}`;
+    }
+  }
+  return event.artifact_id ?? "unknown";
+}
 function dispatchPayload(event) {
   const schema = DISPATCH_PAYLOAD_SCHEMAS[event.type];
   if (schema === undefined)
@@ -31444,7 +31476,8 @@ function renderInbound(raw, sessionID, subject) {
         }
         askQuestion = dispatchAskQuestion(frame.event);
         dispatchEvent = {
-          issue_key: frame.event.issue_key,
+          owner: dispatchOwner(frame.event, subject ?? envelope.topic),
+          ...frame.event.issue_key === null ? frame.event.artifact_id === undefined || frame.event.artifact_id === null ? {} : { artifact_id: frame.event.artifact_id } : { issue_key: frame.event.issue_key },
           type: frame.event.type,
           actor: frame.event.actor,
           payload: dispatchPayload(frame.event)
@@ -31897,6 +31930,23 @@ var nativeIssueKeyPattern = /^[A-Z][A-Z0-9]{1,9}-[0-9]+$/;
 var externalIssueRefPattern = /^([^/\s]+)\/([^/\s#]+)#([1-9][0-9]*)$/;
 var bareIssueNumberPattern = /^[1-9][0-9]*$/;
 var issueFreeTools = new Set(["dispatch_issue", "dispatch_resolve_ask", "dispatch_search"]);
+async function askResultDetails(client, ask) {
+  if (ask.issue_key !== null) {
+    return {
+      issue: ask.issue_key,
+      topic: dispatchIssueSubject(ask.issue_key, ">"),
+      ask: ask.id
+    };
+  }
+  if (ask.artifact_id === undefined || ask.artifact_id === null) {
+    throw new Error("document ask is missing its artifact ID");
+  }
+  const artifact = await client.getArtifact(ask.artifact_id);
+  return {
+    topic: `notifications.dispatch.document.${artifact.project}.${artifact.slug}.>`,
+    ask: ask.id
+  };
+}
 function canonicalExternalIssueRef(value) {
   const match = value.trim().match(externalIssueRefPattern);
   return match ? `${canonicalRepo(match[1] ?? "", match[2] ?? "")}#${match[3]}` : value;
@@ -32212,11 +32262,7 @@ async function executeDispatchTool(input) {
         throw new Error("resolved ask is missing its resolution");
       return {
         text: `${kind === "retracted" ? "Retracted" : "Resolved"} ask ${ask.id}: ${ask.resolution.reason}`,
-        details: {
-          issue: ask.issue_key,
-          topic: dispatchIssueSubject(ask.issue_key, ">"),
-          ask: ask.id
-        }
+        details: await askResultDetails(client, ask)
       };
     }
     case "dispatch_ask": {
@@ -32236,11 +32282,7 @@ async function executeDispatchTool(input) {
       });
       return {
         text: `Opened ask ${ask.id}: ${ask.question}`,
-        details: {
-          issue: ask.issue_key,
-          topic: dispatchIssueSubject(ask.issue_key, ">"),
-          ask: ask.id
-        }
+        details: await askResultDetails(client, ask)
       };
     }
     case "dispatch_comment": {
@@ -32365,7 +32407,7 @@ Open anchored asks/comments: ${marks.join(", ")}`,
         const askRead = await client.getAsk(issueArguments.ref.id);
         return {
           text: askSummary(askRead),
-          details: { issue: askRead.ask.issue_key }
+          details: { issue: issueArguments.ref.issue }
         };
       }
       if (issueArguments.ref?.kind === "comment") {

package/dist/skills/dispatch/SKILL.md

@@ -141,11 +141,16 @@ type EditOp = {
 };
 ```
 
-Target edits by quote: `replace` requires `find` and `with`; `delete` requires `find`; `insert`
-requires `markdown` and exactly one of `after` or `before`. An insert anchor is a quote,
-`"start"`, `"end"`, or `"heading:Title"`. Use zero-based `occurrence` for a repeated `find`.
-When a decision lands, pass `summary` to name the resulting version. Never paste progress into a
-message.
+Target `replace` and `delete` by the document's plain text: inline-code and link text match
+without Markdown syntax, and a table-cell anchor is its cell text. `replace` requires `find` and
+`with`; `delete` requires `find`; `insert` requires `markdown` and exactly one of `after` or
+`before`. An insert anchor is a quote, `"start"`, `"end"`, or `"heading:Title"`. Every insert
+creates a sibling block before or after the quote or heading's enclosing document block; `"start"`
+and `"end"` select the document edges. At a table-cell quote, pipe-table body-row fragments extend
+that table before or after the matched row; omit table header and delimiter rows, and do not exceed
+the table width. Use `replace` for inline continuation. Use zero-based `occurrence` for a repeated
+target. When a decision lands, pass `summary` to name the resulting version. Never paste progress
+into a message.
 
 ## Comments and suggestions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sjawhar/pi-legion-envoy",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "type": "module",
   "omp": {
     "extensions": [