wherever-dev 0.25.1 → 0.26.0

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.
Files changed (75) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/dist/assistant-channels.d.ts +42 -1
  3. package/dist/assistant-channels.d.ts.map +1 -1
  4. package/dist/assistant-channels.js +18 -0
  5. package/dist/assistant-channels.js.map +1 -1
  6. package/dist/cli-requests.d.ts +7 -0
  7. package/dist/cli-requests.d.ts.map +1 -1
  8. package/dist/cli-requests.js +27 -0
  9. package/dist/cli-requests.js.map +1 -1
  10. package/dist/index.js +197 -10
  11. package/dist/index.js.map +1 -1
  12. package/dist/kenning-delivery.d.ts +42 -0
  13. package/dist/kenning-delivery.d.ts.map +1 -0
  14. package/dist/kenning-delivery.js +40 -0
  15. package/dist/kenning-delivery.js.map +1 -0
  16. package/dist/kenning-host.d.ts +93 -0
  17. package/dist/kenning-host.d.ts.map +1 -0
  18. package/dist/kenning-host.js +165 -0
  19. package/dist/kenning-host.js.map +1 -0
  20. package/dist/kenning-human-input.d.ts +70 -0
  21. package/dist/kenning-human-input.d.ts.map +1 -0
  22. package/dist/kenning-human-input.js +87 -0
  23. package/dist/kenning-human-input.js.map +1 -0
  24. package/dist/kenning-service.d.ts +243 -0
  25. package/dist/kenning-service.d.ts.map +1 -0
  26. package/dist/kenning-service.js +516 -0
  27. package/dist/kenning-service.js.map +1 -0
  28. package/dist/protocol.d.ts +41 -1
  29. package/dist/protocol.d.ts.map +1 -1
  30. package/dist/protocol.js.map +1 -1
  31. package/dist/reply-routing.d.ts +26 -0
  32. package/dist/reply-routing.d.ts.map +1 -1
  33. package/dist/reply-routing.js +35 -0
  34. package/dist/reply-routing.js.map +1 -1
  35. package/dist/session-pool.d.ts +35 -0
  36. package/dist/session-pool.d.ts.map +1 -1
  37. package/dist/session-pool.js +104 -7
  38. package/dist/session-pool.js.map +1 -1
  39. package/dist/session-transcript.d.ts.map +1 -1
  40. package/dist/session-transcript.js +34 -2
  41. package/dist/session-transcript.js.map +1 -1
  42. package/dist/session-types.d.ts +24 -1
  43. package/dist/session-types.d.ts.map +1 -1
  44. package/dist/telegram-channel.d.ts +51 -0
  45. package/dist/telegram-channel.d.ts.map +1 -1
  46. package/dist/telegram-channel.js +105 -5
  47. package/dist/telegram-channel.js.map +1 -1
  48. package/package.json +3 -1
  49. package/public/_app/immutable/assets/0.CBxclSgC.css +1 -0
  50. package/public/_app/immutable/chunks/{Cu1cHhsx.js → B_u4L4CL.js} +2 -2
  51. package/public/_app/immutable/chunks/{Cu1cHhsx.js.map → B_u4L4CL.js.map} +1 -1
  52. package/public/_app/immutable/chunks/{C6iQexJ-.js → BgzcA-pV.js} +2 -2
  53. package/public/_app/immutable/chunks/{C6iQexJ-.js.map → BgzcA-pV.js.map} +1 -1
  54. package/public/_app/immutable/chunks/wWzBzbDK.js +2 -0
  55. package/public/_app/immutable/chunks/wWzBzbDK.js.map +1 -0
  56. package/public/_app/immutable/entry/{app.DNzngO5O.js → app.CBSjrM4B.js} +3 -3
  57. package/public/_app/immutable/entry/{app.DNzngO5O.js.map → app.CBSjrM4B.js.map} +1 -1
  58. package/public/_app/immutable/entry/start.fPf-MumQ.js +2 -0
  59. package/public/_app/immutable/entry/start.fPf-MumQ.js.map +1 -0
  60. package/public/_app/immutable/nodes/{0.BS7xCfzW.js → 0.hee657hN.js} +3 -3
  61. package/public/_app/immutable/nodes/{0.BS7xCfzW.js.map → 0.hee657hN.js.map} +1 -1
  62. package/public/_app/immutable/nodes/{1.CkyZ98Lg.js → 1.eykDFZ1z.js} +2 -2
  63. package/public/_app/immutable/nodes/{1.CkyZ98Lg.js.map → 1.eykDFZ1z.js.map} +1 -1
  64. package/public/_app/immutable/nodes/2.DsE4vG-2.js +127 -0
  65. package/public/_app/immutable/nodes/2.DsE4vG-2.js.map +1 -0
  66. package/public/_app/version.json +1 -1
  67. package/public/index.html +11 -11
  68. package/public/service-worker.js +1 -1
  69. package/public/_app/immutable/assets/0.hWfYEET-.css +0 -1
  70. package/public/_app/immutable/chunks/D-x4GEMV.js +0 -2
  71. package/public/_app/immutable/chunks/D-x4GEMV.js.map +0 -1
  72. package/public/_app/immutable/entry/start.B03g92wB.js +0 -2
  73. package/public/_app/immutable/entry/start.B03g92wB.js.map +0 -1
  74. package/public/_app/immutable/nodes/2.CHqhOw3H.js +0 -124
  75. package/public/_app/immutable/nodes/2.CHqhOw3H.js.map +0 -1
@@ -0,0 +1,42 @@
1
+ /**
2
+ * kenning's deliveries, as the chat shows them.
3
+ *
4
+ * kenning-pi delivers messages into a session as pi custom messages with
5
+ * `customType: 'kenning'` (kenning-pi `session.ts` `payload()`): `content` is
6
+ * kenning's formatted text (`format.ts` `formatDelivery`, what the model reads)
7
+ * and `details` is `{ids, from, origins}`, one entry per delivered message. pi
8
+ * persists them as `custom_message` entries (a `message` entry with
9
+ * `role: 'custom'`, which kenning-pi's reconcile also accepts, is read too)
10
+ * and emits them live as a `message_end` (a wake through
11
+ * `sendMessage(..., {triggerTurn: true})`, or what `before_agent_start`
12
+ * returned) or an `entry_appended` (what `agent_before_settle` / `turn_end`
13
+ * returned). Both readers map them here, so history and live frames agree.
14
+ *
15
+ * They are never user messages: no routing entry (ADR 0014), no Telegram, no
16
+ * fork point, no human input. A client sees them only when it asked
17
+ * (`kenning=1` on the socket URL), because an older client maps an unknown
18
+ * history role into a bubble of raw text.
19
+ */
20
+ import type { HistoryMessage, KenningDeliveryInfo } from './session-types.js';
21
+ /** kenning-pi's `CUSTOM_TYPE` (its `shared.ts`). */
22
+ export declare const KENNING_CUSTOM_TYPE = "kenning";
23
+ /** Socket URL parameter a client sets to receive kenning cards. */
24
+ export declare const KENNING_CARDS_PARAM = "kenning";
25
+ export declare function wantsKenningCards(params: URLSearchParams): boolean;
26
+ /**
27
+ * A pi custom message (or `custom_message` entry) as a kenning delivery, or
28
+ * null when it is not one. `details` is read defensively: a transcript written
29
+ * by another kenning-pi version may lack a field, and the card then shows what
30
+ * the text says.
31
+ */
32
+ export declare function kenningDeliveryOf(m: {
33
+ customType?: unknown;
34
+ content?: unknown;
35
+ details?: unknown;
36
+ } | null | undefined): {
37
+ content: string;
38
+ kenning: KenningDeliveryInfo;
39
+ } | null;
40
+ /** History for a client that did not ask for kenning cards: without them. */
41
+ export declare function stripKenningCards(messages: HistoryMessage[]): HistoryMessage[];
42
+ //# sourceMappingURL=kenning-delivery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kenning-delivery.d.ts","sourceRoot":"","sources":["../src/kenning-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAElE;AAeD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACnF;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CAM1D;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAE9E"}
@@ -0,0 +1,40 @@
1
+ /** kenning-pi's `CUSTOM_TYPE` (its `shared.ts`). */
2
+ export const KENNING_CUSTOM_TYPE = 'kenning';
3
+ /** Socket URL parameter a client sets to receive kenning cards. */
4
+ export const KENNING_CARDS_PARAM = 'kenning';
5
+ export function wantsKenningCards(params) {
6
+ return params.get(KENNING_CARDS_PARAM) === '1';
7
+ }
8
+ function strings(v) {
9
+ return Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
10
+ }
11
+ function textOf(content) {
12
+ if (typeof content === 'string')
13
+ return content;
14
+ if (!Array.isArray(content))
15
+ return '';
16
+ return content
17
+ .filter((c) => c && c.type === 'text' && typeof c.text === 'string')
18
+ .map((c) => c.text)
19
+ .join('\n');
20
+ }
21
+ /**
22
+ * A pi custom message (or `custom_message` entry) as a kenning delivery, or
23
+ * null when it is not one. `details` is read defensively: a transcript written
24
+ * by another kenning-pi version may lack a field, and the card then shows what
25
+ * the text says.
26
+ */
27
+ export function kenningDeliveryOf(m) {
28
+ if (!m || m.customType !== KENNING_CUSTOM_TYPE)
29
+ return null;
30
+ const content = textOf(m.content);
31
+ if (!content)
32
+ return null;
33
+ const d = (m.details && typeof m.details === 'object' ? m.details : {});
34
+ return { content, kenning: { ids: strings(d.ids), from: strings(d.from), origins: strings(d.origins) } };
35
+ }
36
+ /** History for a client that did not ask for kenning cards: without them. */
37
+ export function stripKenningCards(messages) {
38
+ return messages.some((m) => m.role === 'kenning') ? messages.filter((m) => m.role !== 'kenning') : messages;
39
+ }
40
+ //# sourceMappingURL=kenning-delivery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kenning-delivery.js","sourceRoot":"","sources":["../src/kenning-delivery.ts"],"names":[],"mappings":"AAqBA,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,OAAO,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,GAAG,CAAC;AACjD,CAAC;AAED,SAAS,OAAO,CAAC,CAAU;IACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,SAAS,MAAM,CAAC,OAAgB;IAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SACxE,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACvB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,CAAoF;IAEpF,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;IACnG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;AAC3G,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,QAA0B;IAC1D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9G,CAAC"}
@@ -0,0 +1,93 @@
1
+ import type { Kenning, KenningHost, SpawnRequest, SpawnResult, StopOutcome } from 'kenning';
2
+ /**
3
+ * wherever as kenning's HOST for spawn and stop (kenning D20, D26, D28, D30;
4
+ * wherever ADR 0024). kenning-pi's `session_spawn` / `session_stop` run inside
5
+ * a session; they look up the process's registered host, and in the server
6
+ * process that is this one, serving every session in the pool:
7
+ *
8
+ * - `spawn` creates a SIDEBAR session in the requested folder (a branch of
9
+ * another transcript when asked), with a live agent and NOTHING sent into it:
10
+ * kenning delivers the first prompt itself, as a `spawn` message from the
11
+ * owner with origin `agent`, which wakes the idle session. No human-input
12
+ * mark is ever emitted for it. Resolves once the session exists.
13
+ * - `stop` aborts only that session's current run; the session stays, and
14
+ * nothing it owns is touched. `not-mine` for a session outside the pool.
15
+ * - kenning wakes only its own headless children (D29), so wherever wakes the
16
+ * ones it spawned: a child the pool evicted while idle (or that a restart
17
+ * left unloaded) is loaded again when a message for it is pending, and
18
+ * kenning-pi then delivers it.
19
+ */
20
+ /**
21
+ * kenning's per-process host registry, on `globalThis[Symbol.for('kenning.host')]`
22
+ * as `{version: 1, entries: [{host}]}` (kenning ADR 0008: the key and the shape
23
+ * are a contract between packages). Written here rather than through kenning's
24
+ * `registerHost` so the server registers at start without loading kenning (and
25
+ * `node:sqlite`) for a user who does not use it; kenning-host.test.ts pins it
26
+ * against kenning's `currentHost()`. Most recent wins; the returned function
27
+ * removes exactly this entry.
28
+ */
29
+ export declare const KENNING_HOST_REGISTRY_KEY: unique symbol;
30
+ export declare function registerKenningHost(host: KenningHost): () => void;
31
+ /** The slice of the session pool the host drives (faked in tests). */
32
+ export interface KenningHostPool {
33
+ spawnSession(opts: {
34
+ folder: string;
35
+ title?: string;
36
+ fork?: {
37
+ sessionFile: string;
38
+ entryId?: string;
39
+ };
40
+ }): Promise<{
41
+ tracked: {
42
+ sessionFile: string;
43
+ };
44
+ } | {
45
+ error: string;
46
+ }>;
47
+ getSession(sessionFileOrId: string): {
48
+ sessionFile: string;
49
+ } | null;
50
+ isStreaming(sessionFileOrId: string): boolean;
51
+ abortSession(sessionFileOrId: string): Promise<void>;
52
+ loadSession(sessionFile: string, cwd?: string): Promise<{
53
+ error?: string;
54
+ }>;
55
+ }
56
+ export declare const KENNING_CHILDREN_FILE = "kenning-children.json";
57
+ export interface WhereverKenningHostOptions {
58
+ pool: KenningHostPool;
59
+ /** wherever's state dir: the list of sessions this server spawned (ADR 0006). */
60
+ stateDir: string;
61
+ /** The open kenning connection, or null while there is none (KenningService). */
62
+ kenning: () => Kenning | null;
63
+ /** A spawn created a session: re-list the sidebar. */
64
+ onSpawned?(sessionFile: string, req: SpawnRequest): void;
65
+ log?: Pick<Console, 'log' | 'warn' | 'error'>;
66
+ }
67
+ export declare class WhereverKenningHost implements KenningHost {
68
+ private readonly opts;
69
+ private readonly children;
70
+ private readonly waking;
71
+ private readonly log;
72
+ constructor(opts: WhereverKenningHostOptions);
73
+ spawn(req: SpawnRequest): Promise<SpawnResult>;
74
+ /** kenning has already checked that `by` owns the target (D31). */
75
+ stop(sessionFile: string, _opts: {
76
+ by: string | null;
77
+ }): Promise<StopOutcome>;
78
+ /** The sessions this server spawned (by file), oldest first. */
79
+ spawned(): string[];
80
+ /**
81
+ * kenning changed: load every child of ours that is not resident, still has
82
+ * its transcript, is not archived (D24) and has a message pending that came
83
+ * after its last stop (D29's rule, so a stopped child is not restarted by the
84
+ * mail it was stopped over). kenning-pi delivers once it starts in it.
85
+ */
86
+ wakeEvicted(): void;
87
+ /** Forget a child whose transcript is gone for good (deleted after its undo window). */
88
+ forget(sessionFile: string): void;
89
+ private file;
90
+ private load;
91
+ private save;
92
+ }
93
+ //# sourceMappingURL=kenning-host.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kenning-host.d.ts","sourceRoot":"","sources":["../src/kenning-host.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE5F;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,eAA6B,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,IAAI,CAWjE;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,eAAe,CAAC;IACtB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAC9B,sDAAsD;IACtD,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;IACzD,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC/C;AAED,qBAAa,mBAAoB,YAAW,WAAW;IAKzC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoE;IAC7F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA0C;gBAEjC,IAAI,EAAE,0BAA0B;IAKvD,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBpD,mEAAmE;IAC7D,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAQnF,gEAAgE;IAChE,OAAO,IAAI,MAAM,EAAE;IAInB;;;;;OAKG;IACH,WAAW,IAAI,IAAI;IA0BnB,wFAAwF;IACxF,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,IAAI;CAWb"}
@@ -0,0 +1,165 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ /**
4
+ * wherever as kenning's HOST for spawn and stop (kenning D20, D26, D28, D30;
5
+ * wherever ADR 0024). kenning-pi's `session_spawn` / `session_stop` run inside
6
+ * a session; they look up the process's registered host, and in the server
7
+ * process that is this one, serving every session in the pool:
8
+ *
9
+ * - `spawn` creates a SIDEBAR session in the requested folder (a branch of
10
+ * another transcript when asked), with a live agent and NOTHING sent into it:
11
+ * kenning delivers the first prompt itself, as a `spawn` message from the
12
+ * owner with origin `agent`, which wakes the idle session. No human-input
13
+ * mark is ever emitted for it. Resolves once the session exists.
14
+ * - `stop` aborts only that session's current run; the session stays, and
15
+ * nothing it owns is touched. `not-mine` for a session outside the pool.
16
+ * - kenning wakes only its own headless children (D29), so wherever wakes the
17
+ * ones it spawned: a child the pool evicted while idle (or that a restart
18
+ * left unloaded) is loaded again when a message for it is pending, and
19
+ * kenning-pi then delivers it.
20
+ */
21
+ /**
22
+ * kenning's per-process host registry, on `globalThis[Symbol.for('kenning.host')]`
23
+ * as `{version: 1, entries: [{host}]}` (kenning ADR 0008: the key and the shape
24
+ * are a contract between packages). Written here rather than through kenning's
25
+ * `registerHost` so the server registers at start without loading kenning (and
26
+ * `node:sqlite`) for a user who does not use it; kenning-host.test.ts pins it
27
+ * against kenning's `currentHost()`. Most recent wins; the returned function
28
+ * removes exactly this entry.
29
+ */
30
+ export const KENNING_HOST_REGISTRY_KEY = Symbol.for('kenning.host');
31
+ export function registerKenningHost(host) {
32
+ const g = globalThis;
33
+ let r = g[KENNING_HOST_REGISTRY_KEY];
34
+ if (!r || !Array.isArray(r.entries))
35
+ r = g[KENNING_HOST_REGISTRY_KEY] = { version: 1, entries: [] };
36
+ const entry = { host };
37
+ r.entries.push(entry);
38
+ return () => {
39
+ const entries = g[KENNING_HOST_REGISTRY_KEY]?.entries;
40
+ const i = entries ? entries.indexOf(entry) : -1;
41
+ if (entries && i >= 0)
42
+ entries.splice(i, 1);
43
+ };
44
+ }
45
+ export const KENNING_CHILDREN_FILE = 'kenning-children.json';
46
+ export class WhereverKenningHost {
47
+ opts;
48
+ children = new Map();
49
+ waking = new Set();
50
+ log;
51
+ constructor(opts) {
52
+ this.opts = opts;
53
+ this.log = opts.log ?? console;
54
+ this.load();
55
+ }
56
+ async spawn(req) {
57
+ if (!req || typeof req.folder !== 'string' || !path.isAbsolute(req.folder))
58
+ throw new Error('spawn needs an absolute folder');
59
+ const r = await this.opts.pool.spawnSession({
60
+ folder: req.folder,
61
+ ...(req.title ? { title: req.title } : {}),
62
+ ...(req.fork ? { fork: req.fork } : {}),
63
+ });
64
+ if ('error' in r)
65
+ throw new Error(r.error);
66
+ const sessionFile = r.tracked.sessionFile;
67
+ this.children.set(sessionFile, { owner: req.owner, folder: req.folder, at: Date.now() });
68
+ this.save();
69
+ this.log.log(`[wherever] kenning: spawned ${sessionFile} for ${req.owner} (${req.spawnId})`);
70
+ try {
71
+ this.opts.onSpawned?.(sessionFile, req);
72
+ }
73
+ catch (err) {
74
+ this.log.error('[wherever] kenning: onSpawned failed:', err);
75
+ }
76
+ return { sessionFile };
77
+ }
78
+ /** kenning has already checked that `by` owns the target (D31). */
79
+ async stop(sessionFile, _opts) {
80
+ const tracked = this.opts.pool.getSession(sessionFile);
81
+ if (!tracked)
82
+ return 'not-mine';
83
+ if (!this.opts.pool.isStreaming(tracked.sessionFile))
84
+ return 'not-running';
85
+ await this.opts.pool.abortSession(tracked.sessionFile);
86
+ return 'stopped';
87
+ }
88
+ /** The sessions this server spawned (by file), oldest first. */
89
+ spawned() {
90
+ return [...this.children.entries()].sort((a, b) => a[1].at - b[1].at).map(([f]) => f);
91
+ }
92
+ /**
93
+ * kenning changed: load every child of ours that is not resident, still has
94
+ * its transcript, is not archived (D24) and has a message pending that came
95
+ * after its last stop (D29's rule, so a stopped child is not restarted by the
96
+ * mail it was stopped over). kenning-pi delivers once it starts in it.
97
+ */
98
+ wakeEvicted() {
99
+ const k = this.opts.kenning();
100
+ if (!k)
101
+ return;
102
+ for (const [file, child] of this.children) {
103
+ if (this.waking.has(file) || this.opts.pool.getSession(file))
104
+ continue;
105
+ if (!fs.existsSync(file))
106
+ continue;
107
+ try {
108
+ if (k.archiveMark(file))
109
+ continue;
110
+ const since = k.lastStopAt(file) ?? -1;
111
+ if (!k.pendingFor(file).some((m) => m.createdAt > since))
112
+ continue;
113
+ }
114
+ catch (err) {
115
+ this.log.warn(`[wherever] kenning: checking ${file} failed: ${err.message}`);
116
+ continue;
117
+ }
118
+ this.waking.add(file);
119
+ void this.opts.pool
120
+ .loadSession(file, child.folder)
121
+ .then((r) => {
122
+ if (r.error)
123
+ this.log.warn(`[wherever] kenning: could not wake ${file}: ${r.error}`);
124
+ else
125
+ this.log.log(`[wherever] kenning: woke ${file} (a message is waiting for it)`);
126
+ })
127
+ .catch((err) => this.log.warn(`[wherever] kenning: could not wake ${file}: ${err.message}`))
128
+ .finally(() => this.waking.delete(file));
129
+ }
130
+ }
131
+ /** Forget a child whose transcript is gone for good (deleted after its undo window). */
132
+ forget(sessionFile) {
133
+ if (this.children.delete(sessionFile))
134
+ this.save();
135
+ }
136
+ file() {
137
+ return path.join(this.opts.stateDir, KENNING_CHILDREN_FILE);
138
+ }
139
+ load() {
140
+ try {
141
+ const raw = JSON.parse(fs.readFileSync(this.file(), 'utf8'));
142
+ for (const [f, c] of Object.entries(raw.children ?? {})) {
143
+ if (c && typeof c.owner === 'string' && typeof c.folder === 'string')
144
+ this.children.set(f, { owner: c.owner, folder: c.folder, at: typeof c.at === 'number' ? c.at : 0 });
145
+ }
146
+ }
147
+ catch (err) {
148
+ if (err.code !== 'ENOENT')
149
+ this.log.warn(`[wherever] kenning: ignoring an unreadable ${KENNING_CHILDREN_FILE}: ${err.message}`);
150
+ }
151
+ }
152
+ save() {
153
+ const file = this.file();
154
+ const tmp = `${file}.tmp`;
155
+ try {
156
+ fs.mkdirSync(path.dirname(file), { recursive: true });
157
+ fs.writeFileSync(tmp, JSON.stringify({ children: Object.fromEntries(this.children) }, null, 2) + '\n', { mode: 0o600 });
158
+ fs.renameSync(tmp, file);
159
+ }
160
+ catch (err) {
161
+ this.log.warn(`[wherever] kenning: could not record spawned sessions: ${err.message}`);
162
+ }
163
+ }
164
+ }
165
+ //# sourceMappingURL=kenning-host.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kenning-host.js","sourceRoot":"","sources":["../src/kenning-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAEpE,MAAM,UAAU,mBAAmB,CAAC,IAAiB;IACnD,MAAM,CAAC,GAAG,UAAqG,CAAC;IAChH,IAAI,CAAC,GAAG,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,yBAAyB,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACpG,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,GAAG,EAAE;QACV,MAAM,OAAO,GAAG,CAAC,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;QACtD,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC;AAeD,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAa7D,MAAM,OAAO,mBAAmB;IAKD;IAJZ,QAAQ,GAAG,IAAI,GAAG,EAAyD,CAAC;IAC5E,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3B,GAAG,CAA0C;IAE9D,YAA6B,IAAgC;QAAhC,SAAI,GAAJ,IAAI,CAA4B;QAC3D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAiB;QAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC9H,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YAC1C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC;QACH,IAAI,OAAO,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,+BAA+B,WAAW,QAAQ,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC;QAC7F,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,WAAW,EAAE,CAAC;IACzB,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,KAA4B;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO;YAAE,OAAO,UAAU,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,OAAO,aAAa,CAAC;QAC3E,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gEAAgE;IAChE,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAED;;;;;OAKG;IACH,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YACvE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,SAAS;YACnC,IAAI,CAAC;gBACH,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAClC,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC;oBAAE,SAAS;YACrE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,IAAI,YAAa,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtB,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI;iBAChB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;iBAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,IAAI,CAAC,CAAC,KAAK;oBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAsC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;;oBAChF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,4BAA4B,IAAI,gCAAgC,CAAC,CAAC;YACtF,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAsC,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;iBACtG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,WAAmB;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACrD,CAAC;IAEO,IAAI;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAC9D,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAiF,CAAC;YAC7I,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;oBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5K,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,8CAA8C,qBAAqB,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxK,CAAC;IACH,CAAC;IAEO,IAAI;QACV,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;QAC1B,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxH,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,0DAA2D,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACpG,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,70 @@
1
+ import type { InlineExtension } from '@earendil-works/pi-coding-agent';
2
+ import { type ReplyOrigin } from './reply-routing.js';
3
+ /**
4
+ * Marking human input for kenning (kenning's D22 and ADR 0003, wherever ADR 0023).
5
+ *
6
+ * kenning records a user message as the HUMAN's words (which only then may be
7
+ * relayed as `human-relayed` to satisfy another session's safety gate) when the
8
+ * host emits `kenning:human-input` `{text, channel}` on that session's
9
+ * `pi.events` bus right before sending the text. The bus belongs to one
10
+ * session's resource loader, and no tool can reach it, so the model cannot
11
+ * produce a mark.
12
+ *
13
+ * wherever marks exactly the sends a human typed: a web send (routing origin
14
+ * `none`, ADR 0014) and a Telegram send (`telegram`, `telegram:<sub>`). Never a
15
+ * scheduled job (`schedule:<jobId>`), never anything else. A new pool caller
16
+ * that is not a human MUST pass its own origin, since an omitted origin means a
17
+ * web send.
18
+ */
19
+ /**
20
+ * The event kenning-pi listens for: kenning's `HUMAN_INPUT_EVENT` (its
21
+ * `host.ts`), copied so that loading the session pool does not load kenning
22
+ * (and `node:sqlite`) for a user who does not use it. kenning-human-input.test.ts
23
+ * pins it against kenning's constant.
24
+ */
25
+ export declare const HUMAN_INPUT_EVENT = "kenning:human-input";
26
+ /**
27
+ * kenning's `HUMAN_INPUT_END_EVENT` (kenning D35), copied for the same reason:
28
+ * emitted once the marked, AWAITED send settled, so kenning drops the mark if
29
+ * no input consumed it. Server sessions only: the CLI bridge's
30
+ * `pi.sendUserMessage()` is fire-and-forget, so an end there could drop a mark
31
+ * that is about to match (it relies on kenning's 5 s expiry instead).
32
+ */
33
+ export declare const HUMAN_INPUT_END_EVENT = "kenning:human-input-end";
34
+ export type HumanInputChannel = 'web' | 'telegram';
35
+ /** The kenning channel of a routing origin, or null when the send is not a human's. */
36
+ export declare function humanInputChannel(origin: ReplyOrigin | null | undefined): HumanInputChannel | null;
37
+ /** The slice of a pi AgentSession `willReachInputEvent` reads. */
38
+ export interface InputEventProbe {
39
+ readonly isCompacting: boolean;
40
+ readonly extensionRunner?: {
41
+ getCommand(name: string): unknown;
42
+ } | undefined;
43
+ }
44
+ /**
45
+ * Whether pi's `prompt()` will emit the `input` event for this text, which is
46
+ * what consumes a mark. A mark it never consumes stays in kenning-pi's queue
47
+ * and could later match the identical text from a scheduled job, so wherever
48
+ * does not mark a send pi will not pass to `input`: one an extension command
49
+ * handles (`/name ...` with `expandPromptTemplates`, before `input`), or one
50
+ * made while compacting (refused before `input`; auto-compaction is counted
51
+ * too, the safe side). A residue remains: another extension's `input` handler
52
+ * that returns `handled` before kenning-pi's (ADR 0023).
53
+ */
54
+ export declare function willReachInputEvent(session: InputEventProbe, text: string): boolean;
55
+ /** One server session's way onto its own `pi.events` bus. */
56
+ export interface HumanInputMarker {
57
+ /** The inline extension that captures the session's bus (one per agent build). */
58
+ inlineExtension: InlineExtension;
59
+ /** Emit the mark, and return its id for `end`. A no-op until the extension was loaded. */
60
+ mark(text: string, channel: HumanInputChannel): string;
61
+ /** The marked send settled (resolved or threw): close that mark (kenning D35). */
62
+ end(text: string, id: string): void;
63
+ }
64
+ /**
65
+ * Built per server agent (buildServerAgent), like the conversation-mode signal,
66
+ * so a mark can never reach another session's bus. The extension registers
67
+ * nothing the model sees: it only keeps a reference to `pi.events`.
68
+ */
69
+ export declare function createHumanInputMarker(): HumanInputMarker;
70
+ //# sourceMappingURL=kenning-human-input.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kenning-human-input.d.ts","sourceRoot":"","sources":["../src/kenning-human-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,UAAU,CAAC;AAEnD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAIlG;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CAC9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnF;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,eAAe,EAAE,eAAe,CAAC;IACjC,0FAA0F;IAC1F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACvD,kFAAkF;IAClF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAmBzD"}
@@ -0,0 +1,87 @@
1
+ import { WEB_ORIGIN } from './reply-routing.js';
2
+ /**
3
+ * Marking human input for kenning (kenning's D22 and ADR 0003, wherever ADR 0023).
4
+ *
5
+ * kenning records a user message as the HUMAN's words (which only then may be
6
+ * relayed as `human-relayed` to satisfy another session's safety gate) when the
7
+ * host emits `kenning:human-input` `{text, channel}` on that session's
8
+ * `pi.events` bus right before sending the text. The bus belongs to one
9
+ * session's resource loader, and no tool can reach it, so the model cannot
10
+ * produce a mark.
11
+ *
12
+ * wherever marks exactly the sends a human typed: a web send (routing origin
13
+ * `none`, ADR 0014) and a Telegram send (`telegram`, `telegram:<sub>`). Never a
14
+ * scheduled job (`schedule:<jobId>`), never anything else. A new pool caller
15
+ * that is not a human MUST pass its own origin, since an omitted origin means a
16
+ * web send.
17
+ */
18
+ /**
19
+ * The event kenning-pi listens for: kenning's `HUMAN_INPUT_EVENT` (its
20
+ * `host.ts`), copied so that loading the session pool does not load kenning
21
+ * (and `node:sqlite`) for a user who does not use it. kenning-human-input.test.ts
22
+ * pins it against kenning's constant.
23
+ */
24
+ export const HUMAN_INPUT_EVENT = 'kenning:human-input';
25
+ /**
26
+ * kenning's `HUMAN_INPUT_END_EVENT` (kenning D35), copied for the same reason:
27
+ * emitted once the marked, AWAITED send settled, so kenning drops the mark if
28
+ * no input consumed it. Server sessions only: the CLI bridge's
29
+ * `pi.sendUserMessage()` is fire-and-forget, so an end there could drop a mark
30
+ * that is about to match (it relies on kenning's 5 s expiry instead).
31
+ */
32
+ export const HUMAN_INPUT_END_EVENT = 'kenning:human-input-end';
33
+ /** The kenning channel of a routing origin, or null when the send is not a human's. */
34
+ export function humanInputChannel(origin) {
35
+ if (origin === WEB_ORIGIN)
36
+ return 'web';
37
+ if (origin === 'telegram' || (typeof origin === 'string' && origin.startsWith('telegram:')))
38
+ return 'telegram';
39
+ return null;
40
+ }
41
+ /**
42
+ * Whether pi's `prompt()` will emit the `input` event for this text, which is
43
+ * what consumes a mark. A mark it never consumes stays in kenning-pi's queue
44
+ * and could later match the identical text from a scheduled job, so wherever
45
+ * does not mark a send pi will not pass to `input`: one an extension command
46
+ * handles (`/name ...` with `expandPromptTemplates`, before `input`), or one
47
+ * made while compacting (refused before `input`; auto-compaction is counted
48
+ * too, the safe side). A residue remains: another extension's `input` handler
49
+ * that returns `handled` before kenning-pi's (ADR 0023).
50
+ */
51
+ export function willReachInputEvent(session, text) {
52
+ if (session.isCompacting)
53
+ return false;
54
+ if (text.startsWith('/')) {
55
+ const space = text.indexOf(' ');
56
+ const name = space === -1 ? text.slice(1) : text.slice(1, space);
57
+ if (session.extensionRunner?.getCommand(name))
58
+ return false;
59
+ }
60
+ return true;
61
+ }
62
+ /**
63
+ * Built per server agent (buildServerAgent), like the conversation-mode signal,
64
+ * so a mark can never reach another session's bus. The extension registers
65
+ * nothing the model sees: it only keeps a reference to `pi.events`.
66
+ */
67
+ export function createHumanInputMarker() {
68
+ let events = null;
69
+ let seq = 0;
70
+ return {
71
+ inlineExtension: {
72
+ name: 'wherever-human-input',
73
+ factory: (pi) => {
74
+ events = pi.events;
75
+ },
76
+ },
77
+ mark(text, channel) {
78
+ const id = `wherever-${process.pid}-${++seq}`;
79
+ events?.emit(HUMAN_INPUT_EVENT, { text, channel, id });
80
+ return id;
81
+ },
82
+ end(text, id) {
83
+ events?.emit(HUMAN_INPUT_END_EVENT, { text, id });
84
+ },
85
+ };
86
+ }
87
+ //# sourceMappingURL=kenning-human-input.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"kenning-human-input.js","sourceRoot":"","sources":["../src/kenning-human-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAI/D,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,MAAsC;IACtE,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,MAAM,KAAK,UAAU,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IAC/G,OAAO,IAAI,CAAC;AACd,CAAC;AAQD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAwB,EAAE,IAAY;IACxE,IAAI,OAAO,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAYD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,MAAM,GAAkC,IAAI,CAAC;IACjD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,OAAO;QACL,eAAe,EAAE;YACf,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,CAAC,EAAgB,EAAE,EAAE;gBAC5B,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;YACrB,CAAC;SACF;QACD,IAAI,CAAC,IAAI,EAAE,OAAO;YAChB,MAAM,EAAE,GAAG,YAAY,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;YAC9C,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,GAAG,CAAC,IAAI,EAAE,EAAE;YACV,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC"}