@joe-broadhead/messaging 0.7.0 → 0.8.0

package/dist/third-party-notices.md

@@ -167,7 +167,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## ws 8.22.0 (MIT)
+## ws 8.22.1 (MIT)
 
 ```
 Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>

package/dist/third-party.json

@@ -70,7 +70,7 @@
       "text": "MIT License\n\nCopyright (c) 2017 Evgeny Poberezkin\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE."
     },
     "ws": {
-      "version": "8.22.0",
+      "version": "8.22.1",
       "license": "MIT",
       "text": "Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>\nCopyright (c) 2013 Arnout Kazemier and contributors\nCopyright (c) 2016 Luigi Pinca and contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."
     },

package/dist/types/core/agent/operations.d.ts

@@ -1,10 +1,10 @@
-import { type ToolAddress, type ToolConsent, type ToolInput, type ToolOutput } from "../agent-tools.js";
+import { type ToolAddress, type ToolConsent, type ToolInput, type ToolOutput, type TaskReadOutput } from "../agent-tools.js";
 import type * as A2A from "../schema/a2a.js";
 import type { AgentMethod, IpcParams, IpcResult, TaskRecord } from "../schema/ipc.js";
 import { type ToolFramer } from "./text.js";
 /**
- * The eight agent tools' operations (spec §11, "Agent tools"), on the agent IPC methods and
- * `conv.read`, shared by every agent-facing client. Pure: the client injects its daemon link, its
+ * Shared contacts, inbox and task operations on the agent IPC methods.
+ * Pure: the client injects its daemon link, its
  * fence, what the session may reach, and hooks for what it tracks. A client's tool adapter
  * validates input and hands in `assert`, which asks its permission for a conversation; every
  * operation calls it after its own cheap checks and before any side effect or before any peer text
@@ -56,63 +56,16 @@ export interface OperationsContext {
     consent(person: string, self: string): ToolConsent;
     access: ChatAccess;
 }
-/** What a send will do, checked before the permission prompt. */
-export type SendPlan = {
-    kind: "line" | "post";
-    to: ToolAddress;
-    conversation: string;
-    target: string;
-    text: string;
-    thread?: string;
-    request?: {
-        contact: string;
-    };
-} | {
-    kind: "mail" | "task";
-    to: ToolAddress;
-    conversation: string;
-    params: Omit<IpcParams<"msg.send">, "key" | "idempotencyKey">;
-    delegation?: string;
-};
 export declare class Operations {
     private readonly ctx;
     constructor(ctx: OperationsContext);
     private get framer();
     private consent;
-    /** Refuses a chat conversation this client may not reach, before any daemon call. */
-    private reachable;
     contacts(sessionID: string, input: ToolInput<"contacts">, signal?: AbortSignal): Promise<ToolOutput<"contacts">>;
     /**
-     * Checks a send without side effects: the address, the peer-turn allowance, what may go to whom,
-     * what `replyTo` and `onBehalfOf` name. Returns what the send will do, for the permission prompt.
+      * Read a retained task or one of its received envelopes. The peer check precedes any side effect.
      */
-    planSend(sessionID: string, input: ToolInput<"send">, signal?: AbortSignal): Promise<SendPlan>;
-    send(sessionID: string, plan: SendPlan, idempotencyKey: string, signal?: AbortSignal): Promise<ToolOutput<"send">>;
-    /**
-     * What `replyTo` names, for a send to the agent `to`: a message it sent this session (the reply
-     * joins its conversation), or a task this session asked it to run (the text is input for it).
-     */
-    private replyOf;
-    /** The task a send `onBehalfOf` delegates for: this session runs it and it is not finished (spec §6.7). */
-    private delegationParent;
-    /** Lists items; previews put in front of the agent are acknowledged `handed_to_agent` (spec §8.2). */
-    inbox(sessionID: string, input: ToolInput<"inbox">, signal?: AbortSignal): Promise<ToolOutput<"inbox">>;
-    /**
-     * One item: a message or task request this session received (marks it read and sends a read
-     * receipt), a task this session asked for or runs, or something it sent (how far it got).
-     * `assert` gets the item's conversation before anything changes or is shown.
-     */
-    readItem(sessionID: string, id: string, assert: (conversation: string) => Promise<void>, signal?: AbortSignal): Promise<ToolOutput<"read">>;
-    /**
-     * A page of one conversation, oldest first: the chat lines with a person or in a channel, or the
-     * mail and tasks with an agent. Mail previews shown here count as handed to the agent.
-     */
-    readConversation(sessionID: string, input: Pick<ToolInput<"read">, "before" | "after" | "limit"> & {
-        with: string;
-    }, assert: (conversation: string) => Promise<void>, signal?: AbortSignal): Promise<ToolOutput<"read">>;
-    private page;
-    /** Chat lines with persons and in channels. Each conversation in the hits is asserted; `allowed` false drops it. */
-    search(sessionID: string, input: ToolInput<"search">, allowed: (conversation: string) => Promise<boolean>, signal?: AbortSignal): Promise<ToolOutput<"search">>;
+    readItem(sessionID: string, id: string, assertPeer: (person: string) => Promise<void>, signal?: AbortSignal): Promise<TaskReadOutput>;
     tasks(sessionID: string, input: ToolInput<"tasks">, signal?: AbortSignal): Promise<ToolOutput<"tasks">>;
     /**
      * The task an update or a cancel names, checked locally before any permission prompt: this

package/dist/types/core/agent/present.d.ts

@@ -1,5 +1,6 @@
-import { type ToolConsent, type ToolOutput, type ToolTask } from "../agent-tools.js";
-import type { ChatLine, ConvEntry, DirectoryEntry, InboxItem, IpcResult, TaskFollowUp, TaskRecord } from "../schema/ipc.js";
+import { type TaskReadOutput, type ToolConsent, type ToolOutput, type ToolTask } from "../agent-tools.js";
+import type { ConversationToolOutput } from "../conversation-agent-tools.js";
+import type { DirectoryEntry, InboxItem, IpcResult, TaskFollowUp, TaskRecord } from "../schema/ipc.js";
 import { type ToolFramer as Framer } from "./text.js";
 /**
  * Daemon results → agent tool outputs (`AgentTool`, spec §11). Pure. Every string another person
@@ -16,13 +17,8 @@ import { type ToolFramer as Framer } from "./text.js";
  */
 type Contact = ToolOutput<"contacts">["contacts"][number];
 type ContactAgent = NonNullable<Contact["agents"]>[number];
-type InboxOutputItem = ToolOutput<"inbox">["items"][number];
-type ReadItem = Extract<ToolOutput<"read">, {
-    item: unknown;
-}>["item"];
-type PageEntry = Extract<ToolOutput<"read">, {
-    entries: unknown;
-}>["entries"][number];
+type InboxOutputItem = ConversationToolOutput<"inbox">["items"][number];
+type ReadItem = TaskReadOutput["item"];
 type TaskSummary = ToolOutput<"tasks">["tasks"][number];
 export declare const isoOf: (millis: number) => string;
 /** How a request from `person` runs here (spec §11): your own person, a trusted teammate, or a guarded peer turn. */
@@ -34,22 +30,11 @@ export declare function presentAgent(framer: Framer, entry: DirectoryEntry): Con
  */
 export declare function agentCan(entry: Pick<DirectoryEntry, "client">): Contact["can"];
 export declare function presentInboxItem(framer: Framer, item: InboxItem, consent: ToolConsent): InboxOutputItem;
-/** The agent conversation with a peer: `agent:<person>/<agent>`, or `person:<person>` for the person's own. */
-export declare function conversationOfPeer(peer: {
-    person: string;
-    agent?: string;
-}): string;
-export declare function presentMail(framer: Framer, result: Extract<IpcResult<"item.read">, {
+export declare function presentTaskEnvelope(framer: Framer, result: Extract<IpcResult<"item.read">, {
     kind: "received";
 }>, task?: ToolTask): ReadItem;
 /** A task as a read item: its request, with the whole task. */
 export declare function presentTaskItem(framer: Framer, record: TaskRecord, self: string, consent: ToolConsent | undefined): ReadItem;
-/** Something this session sent: no copy is kept, so only how far it got. */
-export declare function presentSent(result: Extract<IpcResult<"item.read">, {
-    kind: "sent";
-}>, self: string): ReadItem;
-export declare function presentLine(framer: Framer, line: ChatLine, kind: "line" | "post", conversation: string): PageEntry;
-export declare function presentConvEntry(framer: Framer, entry: ConvEntry, self: string): PageEntry;
 export declare function presentTask(framer: Framer, record: TaskRecord, consent?: ToolConsent): TaskSummary;
 /** A follow-up's stage says the executor read it. */
 export declare function followUpRead(stage: TaskFollowUp["stage"]): boolean;