@joe-broadhead/messaging 0.8.0 → 0.9.0

package/dist/types/core/schema/ipc/shapes.d.ts

@@ -8,6 +8,13 @@ import { z } from "zod";
 /** Opaque, client-chosen session key, stable for the life of a client session, e.g. "opencode:<sessionID>". */
 export declare const SessionKey: z.ZodString;
 export type SessionKey = z.infer<typeof SessionKey>;
+/**
+ * A source-issued action token (spec §8.2, "Action tokens"): 32 random bytes, base64url. The daemon mints one per
+ * action, item and human-tier view, keeps it in memory only, and spends it at its first presentation. Opaque to
+ * clients; never logged.
+ */
+export declare const ActionToken: z.ZodString;
+export type ActionToken = z.infer<typeof ActionToken>;
 /**
  * When the recipient will likely see a message (spec §8.2): a hint from its machine's last presence
  * at send time, never a promise.
@@ -133,6 +140,21 @@ export declare const TaskFollowUp: z.ZodObject<{
     at: z.ZodNumber;
 }, z.core.$strip>;
 export type TaskFollowUp = z.infer<typeof TaskFollowUp>;
+/** Most characters of `TaskRecord.signIn.tool`: the executor's words, cleaned and capped like a preview. */
+export declare const TASK_SIGN_IN_TOOL_CHARS: 200;
+/** Most characters of `TaskRecord.refusal.reason`: the executor's words, cleaned and capped like a message request. */
+export declare const TASK_REFUSAL_CHARS: 500;
+/** An id a host's engine chose for its session or its pending approval or question: an opaque, plain identifier. */
+export declare const HostLocalId: z.ZodString;
+/**
+ * The executor host's own pending approval or question that an `AUTH_REQUIRED` or `INPUT_REQUIRED` task waits on
+ * (spec §8.2, "The task view"): set by the person's own client with `task.question`, held in this daemon's memory only.
+ */
+export declare const TaskQuestion: z.ZodObject<{
+    sessionId: z.ZodString;
+    approvalId: z.ZodString;
+}, z.core.$strict>;
+export type TaskQuestion = z.infer<typeof TaskQuestion>;
 export declare const TaskRecord: z.ZodObject<{
     task: z.ZodObject<{
         contextId: z.ZodOptional<z.ZodString>;
@@ -248,8 +270,183 @@ export declare const TaskRecord: z.ZodObject<{
         }>;
         at: z.ZodNumber;
     }, z.core.$strip>>>;
+    agent: z.ZodOptional<z.ZodString>;
+    person: z.ZodOptional<z.ZodObject<{
+        id: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    org: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        none: "none";
+        same: "same";
+    }>>;
+    signIn: z.ZodOptional<z.ZodObject<{
+        tool: z.ZodOptional<z.ZodString>;
+        by: z.ZodEnum<{
+            you: "you";
+            them: "them";
+        }>;
+    }, z.core.$strip>>;
+    refusal: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    question: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodString;
+        approvalId: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export type TaskRecord = z.infer<typeof TaskRecord>;
+/**
+ * One side of a task one of this person's agents on this device is in, as the person's own clients see it (spec §8.2,
+ * "The person's tasks"): the task view without the session key (a bearer credential), with `session` the agent's name
+ * and, on the requester side of a task that has not ended, J2's `cancel` action minted for this view.
+ */
+export declare const PersonTask: z.ZodObject<{
+    person: z.ZodOptional<z.ZodObject<{
+        id: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    role: z.ZodEnum<{
+        requester: "requester";
+        executor: "executor";
+    }>;
+    task: z.ZodObject<{
+        contextId: z.ZodOptional<z.ZodString>;
+        status: z.ZodObject<{
+            state: z.ZodEnum<{
+                TASK_STATE_SUBMITTED: "TASK_STATE_SUBMITTED";
+                TASK_STATE_WORKING: "TASK_STATE_WORKING";
+                TASK_STATE_COMPLETED: "TASK_STATE_COMPLETED";
+                TASK_STATE_FAILED: "TASK_STATE_FAILED";
+                TASK_STATE_CANCELED: "TASK_STATE_CANCELED";
+                TASK_STATE_INPUT_REQUIRED: "TASK_STATE_INPUT_REQUIRED";
+                TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
+                TASK_STATE_AUTH_REQUIRED: "TASK_STATE_AUTH_REQUIRED";
+            }>;
+            message: z.ZodOptional<z.ZodObject<{
+                messageId: z.ZodString;
+                contextId: z.ZodOptional<z.ZodString>;
+                taskId: z.ZodOptional<z.ZodString>;
+                role: z.ZodEnum<{
+                    ROLE_USER: "ROLE_USER";
+                    ROLE_AGENT: "ROLE_AGENT";
+                }>;
+                parts: z.ZodArray<z.ZodObject<{
+                    text: z.ZodOptional<z.ZodString>;
+                    raw: z.ZodOptional<z.ZodString>;
+                    url: z.ZodOptional<z.ZodString>;
+                    data: z.ZodOptional<z.ZodUnknown>;
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    filename: z.ZodOptional<z.ZodString>;
+                    mediaType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            artifactId: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            parts: z.ZodArray<z.ZodObject<{
+                text: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+                data: z.ZodOptional<z.ZodUnknown>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        history: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            messageId: z.ZodString;
+            contextId: z.ZodOptional<z.ZodString>;
+            taskId: z.ZodOptional<z.ZodString>;
+            role: z.ZodEnum<{
+                ROLE_USER: "ROLE_USER";
+                ROLE_AGENT: "ROLE_AGENT";
+            }>;
+            parts: z.ZodArray<z.ZodObject<{
+                text: z.ZodOptional<z.ZodString>;
+                raw: z.ZodOptional<z.ZodString>;
+                url: z.ZodOptional<z.ZodString>;
+                data: z.ZodOptional<z.ZodUnknown>;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                filename: z.ZodOptional<z.ZodString>;
+                mediaType: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            extensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            referenceTaskIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    org: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        none: "none";
+        same: "same";
+    }>>;
+    agent: z.ZodOptional<z.ZodString>;
+    chain: z.ZodOptional<z.ZodObject<{
+        addresses: z.ZodArray<z.ZodString>;
+        depth: z.ZodNumber;
+        maxDepth: z.ZodNumber;
+        scope: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exp: z.ZodNumber;
+    }, z.core.$strip>>;
+    peer: z.ZodObject<{
+        address: z.ZodString;
+        person: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        agent: z.ZodOptional<z.ZodString>;
+        device: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    followUps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        envelopeId: z.ZodString;
+        messageId: z.ZodString;
+        sentAt: z.ZodNumber;
+        stage: z.ZodEnum<{
+            accepted: "accepted";
+            relayed: "relayed";
+            delivered: "delivered";
+            held: "held";
+            handed_to_agent: "handed_to_agent";
+            read: "read";
+            replied: "replied";
+            rejected: "rejected";
+            expired: "expired";
+        }>;
+        at: z.ZodNumber;
+    }, z.core.$strip>>>;
+    signIn: z.ZodOptional<z.ZodObject<{
+        tool: z.ZodOptional<z.ZodString>;
+        by: z.ZodEnum<{
+            you: "you";
+            them: "them";
+        }>;
+    }, z.core.$strip>>;
+    refusal: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    question: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodString;
+        approvalId: z.ZodString;
+    }, z.core.$strict>>;
+    key: z.ZodOptional<z.ZodNever>;
+    session: z.ZodString;
+    cancel: z.ZodOptional<z.ZodObject<{
+        name: z.ZodLiteral<"cancel">;
+        token: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type PersonTask = z.infer<typeof PersonTask>;
 /**
  * Where a retained task envelope went: an agent session `person/agent@label`.
  */
@@ -302,6 +499,7 @@ export declare const SendResult: z.ZodObject<{
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
         conv_conflict: "conv_conflict";
+        conflict: "conflict";
         stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";

package/dist/types/core/schema/ipc/surfaces.d.ts

@@ -229,6 +229,7 @@ export declare const SURFACE_METHODS: {
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
                     conv_conflict: "conv_conflict";
+                    conflict: "conflict";
                     stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";

package/dist/types/core/schema/ipc/tasks.d.ts

@@ -76,6 +76,7 @@ export declare const TASK_SEND_METHODS: {
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
                     conv_conflict: "conv_conflict";
+                    conflict: "conflict";
                     stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";
@@ -176,6 +177,7 @@ export declare const TASK_SEND_METHODS: {
                     jelly_unavailable: "jelly_unavailable";
                     log_conflict: "log_conflict";
                     conv_conflict: "conv_conflict";
+                    conflict: "conflict";
                     stale_epoch: "stale_epoch";
                     device_limit: "device_limit";
                     admission_required: "admission_required";