sessionpipe-core 0.13.2 → 0.13.4

package/dist/src/adapters/types.d.ts

@@ -35,16 +35,35 @@ export interface Turn {
      *  daemon reaches a session in place (spec/CONTROL.md §6.3, §8). The words are the
      *  person's; the arrival was not. */
     injected?: true;
+    /** The harness's own id for the turn's prompt, where its transcript records one (Claude
+     *  Code's `promptId`, the `prompt_id` of its hooks): what `turn.started` named the turn. */
+    id?: string;
+    /** The person stopped the turn before it finished, and the transcript says so. Such a
+     *  turn is whole as it stands, with whatever it had said (nothing, sometimes): no hook
+     *  fires for it, so the file is the only thing that knows. */
+    interrupted?: true;
 }
 export interface TranscriptRead {
     turns: Turn[];
     /** The line the cursor may advance to once every turn is delivered. */
     line: number;
-    /** A prompt after the last turn with no reply yet (a turn that just began). */
+    /** A prompt after the last turn with no reply yet (a turn that just began), with the
+     *  harness's own id for it where its transcript records one (as `Turn.id`). */
     open?: {
         user: string;
         at: number;
         injected?: true;
+        id?: string;
+    };
+    /** The last of `turns`, for a caller that may have to hold it back because the file is
+     *  still being written: the line it starts on (where the cursor stops if it is held),
+     *  and `said`, the assistant's last words in it when nothing of that turn follows them
+     *  (no tool call, no tool result). A harness names a turn's last words as the turn ends
+     *  (Claude Code's `last_assistant_message`); until `said` is those words, the end of the
+     *  turn is not in the file yet. Absent when there are no turns. */
+    tail?: {
+        start: number;
+        said?: string;
     };
 }
 export interface SessionFacts extends Partial<Session> {

package/dist/src/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/types.ts"],"names":[],"mappings":"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"}

package/dist/src/control/frames.d.ts

@@ -0,0 +1,87 @@
+/** The receiver's own host, for a line a person reads; the whole string when it is not
+ *  a URL. */
+export declare function hostOf(receiver: string): string;
+/** Said with every message that reaches a live session: the answer goes back by itself
+ *  (the daemon reads it from the transcript), so the model never invents a command to
+ *  reply with (a real session tried `sessionpipe send`, 2026-10-01). */
+export declare const IN_PLACE_ANSWER = "Answer it right here, as you would answer the person at the keyboard: your reply is sent back to them automatically. Don't run a command or call a tool just to send it.";
+/** What held a session when a copy of it was made instead (CONTROL.md §6, What counts as
+ *  held), as the machine found it: a window the person has it open in, another process's
+ *  run of it, or only a write to its transcript too recent to account for. */
+export declare const COPY_WHYS: readonly ["open", "running", "recent"];
+export type CopyWhy = (typeof COPY_WHYS)[number];
+/** Said with a message a copy of a session is answering, so the model knows its reply is
+ *  the only part the person sees, while its work is as real as the original's. The first
+ *  note said "nothing you do here appears in it … don't carry on the original's work", and
+ *  a copy asked to change a page answered that a copy can't publish (2026-11-05). Why
+ *  there is a copy is said as the machine found it: an original that is open in a
+ *  window, or one that something else is using. */
+export declare const copyNote: (why: CopyWhy) => string;
+/** Said after a message `sessionpipe wait` prints (CONTROL.md §8), so the session starts
+ *  the waiter again. */
+export declare const RE_ARM = "(Answer it right here, as you would answer the person at the keyboard: your reply is sent back to them automatically, so don't run a command or call a tool just to send it. Then, without mentioning it, start `sessionpipe wait` again as a background command, with the longest timeout your harness allows, to keep receiving messages.)";
+/** The framed text a session receives (CONTROL.md §6): the model and the person can tell
+ *  where it came from. */
+export declare function frame(text: string, receiver: string): string;
+/** What the daemon looks for in the row the session's transcript records for a message
+ *  handed to it in place (§6 `prompt`, §6.3): a turn is only proof of delivery when it is
+ *  THIS message's turn, and only what the session wrote after that row is its answer.
+ *
+ *  Null for an id that is not a whole ULID. The id is the receiver's and nobody signed
+ *  it: its characters go into a header that says "signed on the sender's device" and
+ *  into the session's context, so nothing but the alphabet of a ULID is ever taken from
+ *  it (an id of `x\n\nrm -rf ~` put those words in the header), and a short one ("42")
+ *  would make a mark anybody's words contain. */
+export declare const messageMark: (id: string) => string | null;
+/** The framed text for a message handed to a live session in place — at its Stop, to
+ *  its waiter, into its inbox: `frame()` with that mark in it, since the session answers
+ *  in a turn of its own and the daemon has to recognise the message again in the
+ *  transcript to know which words are its answer. A message whose id makes no mark gets
+ *  `frame()` as it is: nothing of the id reaches the session. */
+export declare function frameMarked(text: string, receiver: string, id: string): string;
+/** A new session's first message: the person's words first, where they come from after
+ *  (Claude Code names a session from the start of its first message). */
+export declare function frameStart(text: string, receiver: string): string;
+/** What a session another session asked receives (CONTROL.md §13), new or not: the task
+ *  first, then who asked and that the answer travels by itself. Handed to a live session
+ *  in place it names the message too (`mark`), which is how the daemon finds the answer
+ *  in that session's transcript. */
+export declare function frameAsk(text: string, from: string | undefined, mark?: string | null): string;
+/** A handoff's answer as it lands in `reply_to` (CONTROL.md §6). `from` is the session
+ *  that answered, as a person reads it (`<harness>:<short id>`). */
+export declare function frameHandoff(from: string, receiver: string, reply: string): string;
+/** `frame()` and `frameMarked()` undone, and nothing else: the person's words, and the
+ *  host they were sent from. A channel shows the words as the message and says where
+ *  they came from beside it (CONTROL.md §8). Text neither of them made comes back whole,
+ *  from nowhere. */
+export declare function unframe(text: string): {
+    text: string;
+    via: string | null;
+};
+/** A delivered message with sessionpipe's own words taken off: the line that says where
+ *  it came from (before the words for a message into a session that exists, after them
+ *  for a new session's first), and the one note to the model that may follow the words
+ *  (how the answer travels, that the session is a copy, to start the waiter again).
+ *
+ *  Only where sessionpipe puts them. A sentence is taken off in the place and the form
+ *  the daemon builds it in, never because a paragraph somewhere reads like one: a person
+ *  can type or paste any of these words, and a prompt that is nothing but one of them is
+ *  what the person wrote. So a note comes off only after the words of a text that carries
+ *  a frame, a frame's line only with words beside it, and text in no shape the daemon
+ *  builds comes back exactly as it was, `delivered: false`. `via` is the receiver's host
+ *  when the frame names one.
+ *
+ *  Kept, because they say whose words these are and not how they travelled: the
+ *  paragraph `frameAsk` puts after a task (`(Asked by <session> on this machine with
+ *  sessionpipe ask. …)`, in that plain form whether or not the ask named its message on
+ *  the way), and the first line of a handoff's answer. The task is an
+ *  agent's and the answer is an agent's; a receiver tells them from the person's own
+ *  words by exactly those lines, so a text without them would be drawn as something the
+ *  person wrote. Kept too, because it is what the message says: the list of attached
+ *  files. */
+export declare function deliveredWords(text: string): {
+    text: string;
+    via: string | null;
+    delivered: boolean;
+};
+//# sourceMappingURL=frames.d.ts.map

package/dist/src/control/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../../src/control/frames.ts"],"names":[],"mappings":"AASA;aACa;AACb,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;wEAEwE;AACxE,eAAO,MAAM,eAAe,6KACgJ,CAAC;AAE7K;;8EAE8E;AAC9E,eAAO,MAAM,SAAS,YAAI,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAChE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD;;;;;mDAKmD;AACnD,eAAO,MAAM,QAAQ,QAAS,OAAO,KAAG,MACyZ,CAAC;AAElc;wBACwB;AACxB,eAAO,MAAM,MAAM,iVAC6T,CAAC;AAEjV;0BAC0B;AAC1B,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAMD;;;;;;;;iDAQiD;AACjD,eAAO,MAAM,WAAW,OAAQ,MAAM,KAAG,MAAM,GAAG,IAA+D,CAAC;AAKlH;;;;iEAIiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;yEACyE;AACzE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;oCAGoC;AACpC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE7F;AAED;oEACoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElF;AAuDD;;;oBAGoB;AACpB,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAI1E;AAED;;;;;;;;;;;;;;;;;;;;aAoBa;AACb,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAuBrG"}

package/dist/src/control/index.d.ts

@@ -1,5 +1,6 @@
 /** sessionpipe-core/control — the signed control command: format, verification,
- *  enrollment (spec/CONTROL.md). WebCrypto only; safe to import in a Worker or a
- *  browser (no node: imports). */
+ *  enrollment (spec/CONTROL.md), and the words a delivered message is framed in.
+ *  WebCrypto only; safe to import in a Worker or a browser (no node: imports). */
+export * from "./frames.js";
 export * from "./verify.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/control/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/control/index.ts"],"names":[],"mappings":"AACA;;kCAEkC;AAClC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/control/index.ts"],"names":[],"mappings":"AACA;;kFAEkF;AAClF,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/src/readers/transcripts.d.ts

@@ -1,6 +1,7 @@
 import type { TranscriptRead } from "../adapters/types.js";
 interface Msg {
-    role: "user" | "assistant";
+    /** `interrupt` carries no words: the person stopped the running turn at this line. */
+    role: "user" | "assistant" | "interrupt";
     text: string;
     at: number;
     line: number;
@@ -9,8 +10,12 @@ interface Msg {
      *  control daemon reaches a session in place (spec/CONTROL.md §6.3, §8). The words are
      *  the person's; the arrival was not. */
     injected?: true;
+    /** The harness's own id for the prompt (a `user` message's only). */
+    id?: string;
 }
-export declare function pairTurns(msgs: Msg[], endLine: number): TranscriptRead;
+/** `tail`: also say where the last turn starts and what the assistant said last in it
+ *  (TranscriptRead.tail), for a reader whose harness names a turn's last words. */
+export declare function pairTurns(msgs: Msg[], endLine: number, tail?: boolean): TranscriptRead;
 /** Injected context the person never typed: <tag>…</tag> wrappers (the tag may carry
  *  attributes, as Claude Code's `<cross-session-message from="…">` does), HTML comments,
  *  slash-command expansions. */

package/dist/src/readers/transcripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcripts.d.ts","sourceRoot":"","sources":["../../../src/readers/transcripts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,UAAU,GAAG;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb;;;6CAGyC;IACzC,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAiDtE;AAED;;gCAEgC;AAChC,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAGjB,CAAC;AA+C1B;;;wEAGwE;AACxE,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7D;AAyBD;oGACoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAuCxE;AAED;;gEAEgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,gIAAgI;AAChI,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAqBvE;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAcxE;AAED,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAgB7E"}
+{"version":3,"file":"transcripts.d.ts","sourceRoot":"","sources":["../../../src/readers/transcripts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,UAAU,GAAG;IACX,sFAAsF;IACtF,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb;;;6CAGyC;IACzC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;mFACmF;AACnF,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,cAAc,CA6EpF;AAED;;gCAEgC;AAChC,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,OAGjB,CAAC;AA0D1B;;;wEAGwE;AACxE,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7D;AA+CD;oGACoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAwExE;AAED;;gEAEgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,gIAAgI;AAChI,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAqBvE;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAcxE;AAED,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAgB7E"}

package/dist/version.js

@@ -1,4 +1,4 @@
-// sessionpipe-core 0.13.2 · Apache-2.0 · https://sessionpipe.org
+// sessionpipe-core 0.13.4 · Apache-2.0 · https://sessionpipe.org
 
 // src/version.ts
 import { spawn } from "node:child_process";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessionpipe-core",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "description": "sessionpipe core: protocol types, harness adapters, privacy filter and redaction rulesets, outbox and sinks. Zero runtime dependencies. (published unscoped until the @sessionpipe npm org exists; the code is the same)",
   "license": "Apache-2.0",
   "type": "module",