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.
- package/CHANGELOG.md +26 -0
- package/dist/assistant-channels.d.ts +42 -1
- package/dist/assistant-channels.d.ts.map +1 -1
- package/dist/assistant-channels.js +18 -0
- package/dist/assistant-channels.js.map +1 -1
- package/dist/cli-requests.d.ts +7 -0
- package/dist/cli-requests.d.ts.map +1 -1
- package/dist/cli-requests.js +27 -0
- package/dist/cli-requests.js.map +1 -1
- package/dist/index.js +197 -10
- package/dist/index.js.map +1 -1
- package/dist/kenning-delivery.d.ts +42 -0
- package/dist/kenning-delivery.d.ts.map +1 -0
- package/dist/kenning-delivery.js +40 -0
- package/dist/kenning-delivery.js.map +1 -0
- package/dist/kenning-host.d.ts +93 -0
- package/dist/kenning-host.d.ts.map +1 -0
- package/dist/kenning-host.js +165 -0
- package/dist/kenning-host.js.map +1 -0
- package/dist/kenning-human-input.d.ts +70 -0
- package/dist/kenning-human-input.d.ts.map +1 -0
- package/dist/kenning-human-input.js +87 -0
- package/dist/kenning-human-input.js.map +1 -0
- package/dist/kenning-service.d.ts +243 -0
- package/dist/kenning-service.d.ts.map +1 -0
- package/dist/kenning-service.js +516 -0
- package/dist/kenning-service.js.map +1 -0
- package/dist/protocol.d.ts +41 -1
- package/dist/protocol.d.ts.map +1 -1
- package/dist/protocol.js.map +1 -1
- package/dist/reply-routing.d.ts +26 -0
- package/dist/reply-routing.d.ts.map +1 -1
- package/dist/reply-routing.js +35 -0
- package/dist/reply-routing.js.map +1 -1
- package/dist/session-pool.d.ts +35 -0
- package/dist/session-pool.d.ts.map +1 -1
- package/dist/session-pool.js +104 -7
- package/dist/session-pool.js.map +1 -1
- package/dist/session-transcript.d.ts.map +1 -1
- package/dist/session-transcript.js +34 -2
- package/dist/session-transcript.js.map +1 -1
- package/dist/session-types.d.ts +24 -1
- package/dist/session-types.d.ts.map +1 -1
- package/dist/telegram-channel.d.ts +51 -0
- package/dist/telegram-channel.d.ts.map +1 -1
- package/dist/telegram-channel.js +105 -5
- package/dist/telegram-channel.js.map +1 -1
- package/package.json +3 -1
- package/public/_app/immutable/assets/0.CBxclSgC.css +1 -0
- package/public/_app/immutable/chunks/{Cu1cHhsx.js → B_u4L4CL.js} +2 -2
- package/public/_app/immutable/chunks/{Cu1cHhsx.js.map → B_u4L4CL.js.map} +1 -1
- package/public/_app/immutable/chunks/{C6iQexJ-.js → BgzcA-pV.js} +2 -2
- package/public/_app/immutable/chunks/{C6iQexJ-.js.map → BgzcA-pV.js.map} +1 -1
- package/public/_app/immutable/chunks/wWzBzbDK.js +2 -0
- package/public/_app/immutable/chunks/wWzBzbDK.js.map +1 -0
- package/public/_app/immutable/entry/{app.DNzngO5O.js → app.CBSjrM4B.js} +3 -3
- package/public/_app/immutable/entry/{app.DNzngO5O.js.map → app.CBSjrM4B.js.map} +1 -1
- package/public/_app/immutable/entry/start.fPf-MumQ.js +2 -0
- package/public/_app/immutable/entry/start.fPf-MumQ.js.map +1 -0
- package/public/_app/immutable/nodes/{0.BS7xCfzW.js → 0.hee657hN.js} +3 -3
- package/public/_app/immutable/nodes/{0.BS7xCfzW.js.map → 0.hee657hN.js.map} +1 -1
- package/public/_app/immutable/nodes/{1.CkyZ98Lg.js → 1.eykDFZ1z.js} +2 -2
- package/public/_app/immutable/nodes/{1.CkyZ98Lg.js.map → 1.eykDFZ1z.js.map} +1 -1
- package/public/_app/immutable/nodes/2.DsE4vG-2.js +127 -0
- package/public/_app/immutable/nodes/2.DsE4vG-2.js.map +1 -0
- package/public/_app/version.json +1 -1
- package/public/index.html +11 -11
- package/public/service-worker.js +1 -1
- package/public/_app/immutable/assets/0.hWfYEET-.css +0 -1
- package/public/_app/immutable/chunks/D-x4GEMV.js +0 -2
- package/public/_app/immutable/chunks/D-x4GEMV.js.map +0 -1
- package/public/_app/immutable/entry/start.B03g92wB.js +0 -2
- package/public/_app/immutable/entry/start.B03g92wB.js.map +0 -1
- package/public/_app/immutable/nodes/2.CHqhOw3H.js +0 -124
- 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":"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"}
|
|
@@ -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"}
|