@canonmsg/codex-plugin 0.18.11 → 0.19.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/README.md +2 -2
- package/dist/app-server-adapter.d.ts +5 -0
- package/dist/app-server-adapter.js +36 -5
- package/dist/app-server-approval.d.ts +1 -1
- package/dist/app-server-approval.js +1 -1
- package/dist/bridge-bin.d.ts +14 -0
- package/dist/bridge-bin.js +27 -0
- package/dist/cli-entry.d.ts +2 -2
- package/dist/cli-entry.js +1 -1
- package/dist/codex-app-tools.d.ts +42 -0
- package/dist/codex-app-tools.js +519 -0
- package/dist/control-channel.d.ts +26 -46
- package/dist/control-channel.js +37 -50
- package/dist/host.d.ts +1 -1
- package/dist/host.js +840 -929
- package/dist/register.js +73 -25
- package/dist/session-store.d.ts +1 -1
- package/dist/session-store.js +2 -2
- package/dist/turn-activity.d.ts +7 -11
- package/dist/turn-activity.js +7 -41
- package/package.json +10 -7
- package/dist/host-lifecycle.d.ts +0 -4
- package/dist/host-lifecycle.js +0 -3
- package/dist/inbound-policy.d.ts +0 -22
- package/dist/inbound-policy.js +0 -46
- package/dist/startup-recovery.d.ts +0 -46
- package/dist/startup-recovery.js +0 -59
package/dist/register.js
CHANGED
|
@@ -2,8 +2,45 @@
|
|
|
2
2
|
import { setDefaultResultOrder } from 'node:dns';
|
|
3
3
|
import { readFileSync } from 'node:fs';
|
|
4
4
|
import { parseArgs } from 'node:util';
|
|
5
|
-
import {
|
|
5
|
+
import { ackRegistrationApprovalWith, resolveCanonBaseUrl, runRegistrationFlow, } from '@canonmsg/core/contract';
|
|
6
|
+
import { clearPendingRegistration, getOrCreatePendingRegistration, updatePendingRegistration, upsertAgentProfile, AGENTS_PATH, } from '@canonmsg/core/local';
|
|
7
|
+
import { resolvePackagedBridgeBin } from './bridge-bin.js';
|
|
8
|
+
import { connectBridge } from '@canonmsg/framework';
|
|
6
9
|
import { runCli } from './cli-entry.js';
|
|
10
|
+
/**
|
|
11
|
+
* Registration rides the bridge (Phase 6, same shape as the Hermes port): a
|
|
12
|
+
* short-lived PRE-IDENTITY registration daemon (offline stub +
|
|
13
|
+
* CANON_BRIDGE_REGISTRATION_BASE_URL, managed-child so it dies with this
|
|
14
|
+
* process) serves the three unauthenticated §B10 routes over JSON-RPC.
|
|
15
|
+
*/
|
|
16
|
+
async function openRegistrationBridge(baseUrl) {
|
|
17
|
+
return connectBridge({
|
|
18
|
+
profile: 'registration',
|
|
19
|
+
mode: 'managed-child',
|
|
20
|
+
...(resolvePackagedBridgeBin() ? { binPath: resolvePackagedBridgeBin() } : {}),
|
|
21
|
+
env: {
|
|
22
|
+
...process.env,
|
|
23
|
+
CANON_BRIDGE_AGENT_ID: 'canon-registration',
|
|
24
|
+
CANON_BRIDGE_REGISTRATION_BASE_URL: baseUrl,
|
|
25
|
+
},
|
|
26
|
+
hello: { clientType: 'codex', wantFamilies: [] },
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
function bridgeRegistrationTransport(bridge) {
|
|
30
|
+
return {
|
|
31
|
+
register: (_baseUrl, body) => bridge.client.call('register', body),
|
|
32
|
+
checkStatus: (_baseUrl, requestId, pollToken) => bridge.client.call('getRegistrationStatus', {
|
|
33
|
+
requestId,
|
|
34
|
+
...(pollToken ? { pollToken } : {}),
|
|
35
|
+
}),
|
|
36
|
+
ackRegistrationStatus: async (_baseUrl, requestId, pollToken) => {
|
|
37
|
+
await bridge.client.call('ackRegistrationStatus', {
|
|
38
|
+
requestId,
|
|
39
|
+
...(pollToken ? { pollToken } : {}),
|
|
40
|
+
});
|
|
41
|
+
},
|
|
42
|
+
};
|
|
43
|
+
}
|
|
7
44
|
const HELP = `canon-codex-register — register or reconnect a Codex agent in Canon
|
|
8
45
|
|
|
9
46
|
USAGE
|
|
@@ -52,29 +89,39 @@ export async function main() {
|
|
|
52
89
|
}
|
|
53
90
|
console.log(`Registering Codex agent "${values.name}" (profile: ${profileName})...`);
|
|
54
91
|
const pending = getOrCreatePendingRegistration(profileName, 'codex');
|
|
55
|
-
const
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
92
|
+
const baseUrl = resolveCanonBaseUrl(values['base-url']);
|
|
93
|
+
const bridge = await openRegistrationBridge(baseUrl);
|
|
94
|
+
const transport = bridgeRegistrationTransport(bridge);
|
|
95
|
+
let result;
|
|
96
|
+
try {
|
|
97
|
+
result = await runRegistrationFlow({
|
|
98
|
+
name: values.name,
|
|
99
|
+
description: values.description,
|
|
100
|
+
ownerPhone: values.phone,
|
|
101
|
+
developerInfo: 'Codex host plugin',
|
|
102
|
+
clientType: 'codex',
|
|
103
|
+
baseUrl: values['base-url'],
|
|
104
|
+
requestedAgentId: existingAgentId,
|
|
105
|
+
localRegistrationId: pending.localRegistrationId,
|
|
106
|
+
}, transport, {
|
|
107
|
+
onSubmitted: (requestId, pollToken) => {
|
|
108
|
+
updatePendingRegistration(profileName, {
|
|
109
|
+
requestId,
|
|
110
|
+
pollToken,
|
|
111
|
+
clientType: 'codex',
|
|
112
|
+
});
|
|
113
|
+
console.log(`Registration submitted (request ID: ${requestId}).`);
|
|
114
|
+
console.log('Waiting for approval in Canon app...');
|
|
115
|
+
},
|
|
116
|
+
onPollUpdate: () => {
|
|
117
|
+
process.stdout.write('.');
|
|
118
|
+
},
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
catch (error) {
|
|
122
|
+
bridge.client.close();
|
|
123
|
+
throw error;
|
|
124
|
+
}
|
|
78
125
|
console.log('');
|
|
79
126
|
switch (result.status) {
|
|
80
127
|
case 'approved': {
|
|
@@ -91,7 +138,7 @@ export async function main() {
|
|
|
91
138
|
...(typeof values['base-url'] === 'string' ? { baseUrl: values['base-url'] } : {}),
|
|
92
139
|
});
|
|
93
140
|
if (result.requestId) {
|
|
94
|
-
await
|
|
141
|
+
await ackRegistrationApprovalWith(transport, values['base-url'], result.requestId, result.pollToken);
|
|
95
142
|
}
|
|
96
143
|
clearPendingRegistration(profileName);
|
|
97
144
|
console.log(`Approved! Agent: ${result.agentName} (${result.agentId})`);
|
|
@@ -111,6 +158,7 @@ export async function main() {
|
|
|
111
158
|
process.exit(1);
|
|
112
159
|
break;
|
|
113
160
|
}
|
|
161
|
+
bridge.client.close();
|
|
114
162
|
}
|
|
115
163
|
runCli(import.meta.url, main, (error) => {
|
|
116
164
|
console.error('[canon-codex-register] Fatal error:', error);
|
package/dist/session-store.d.ts
CHANGED
package/dist/session-store.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
2
2
|
import { createHash } from 'node:crypto';
|
|
3
3
|
import { join } from 'node:path';
|
|
4
|
-
import { CANON_DIR, clearRuntimeSessionState, loadRuntimeSessionState, saveRuntimeSessionState, } from '@canonmsg/core';
|
|
4
|
+
import { CANON_DIR, clearRuntimeSessionState, loadRuntimeSessionState, saveRuntimeSessionState, } from '@canonmsg/core/local';
|
|
5
5
|
const STORE_PATH = join(CANON_DIR, 'codex-sessions.json');
|
|
6
6
|
function loadStore() {
|
|
7
7
|
try {
|
|
@@ -17,7 +17,7 @@ function saveStore(store) {
|
|
|
17
17
|
}
|
|
18
18
|
export function buildCodexThreadPolicyFingerprint(input) {
|
|
19
19
|
return createHash('sha256').update(JSON.stringify({
|
|
20
|
-
version:
|
|
20
|
+
version: 2,
|
|
21
21
|
baseCwd: input.baseCwd,
|
|
22
22
|
executionMode: input.executionMode ?? null,
|
|
23
23
|
permissionMode: input.permissionMode ?? null,
|
package/dist/turn-activity.d.ts
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
import type { TurnOutputBlock } from '@canonmsg/core';
|
|
2
1
|
interface RunningCommandBlock {
|
|
3
2
|
command: string;
|
|
4
3
|
blockId: string;
|
|
@@ -8,17 +7,14 @@ export interface CommandBlockTracker {
|
|
|
8
7
|
sequence: number;
|
|
9
8
|
running: RunningCommandBlock[];
|
|
10
9
|
}
|
|
11
|
-
export interface TextSegmentBlockState {
|
|
12
|
-
turnLiveText: string;
|
|
13
|
-
turnBlocks: TurnOutputBlock[];
|
|
14
|
-
}
|
|
15
10
|
export declare function createCommandBlockTracker(): CommandBlockTracker;
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
11
|
+
/**
|
|
12
|
+
* Stable block id for one assistant text segment. The segment state itself
|
|
13
|
+
* (snapshot replacement + live-text rebuild around activity blocks) lives in
|
|
14
|
+
* core's TurnOutputController (`replaceTextSegmentSnapshot`) — this module
|
|
15
|
+
* only owns the codex id scheme.
|
|
16
|
+
*/
|
|
17
|
+
export declare function textSegmentBlockId(turnId: string | null | undefined, itemId?: string): string;
|
|
22
18
|
export declare function beginCommandBlock(tracker: CommandBlockTracker, input: {
|
|
23
19
|
turnId: string | null | undefined;
|
|
24
20
|
command: string;
|
package/dist/turn-activity.js
CHANGED
|
@@ -8,49 +8,15 @@ function normalizeOptionalString(value) {
|
|
|
8
8
|
const normalized = value?.trim();
|
|
9
9
|
return normalized ? normalized : undefined;
|
|
10
10
|
}
|
|
11
|
-
|
|
11
|
+
/**
|
|
12
|
+
* Stable block id for one assistant text segment. The segment state itself
|
|
13
|
+
* (snapshot replacement + live-text rebuild around activity blocks) lives in
|
|
14
|
+
* core's TurnOutputController (`replaceTextSegmentSnapshot`) — this module
|
|
15
|
+
* only owns the codex id scheme.
|
|
16
|
+
*/
|
|
17
|
+
export function textSegmentBlockId(turnId, itemId) {
|
|
12
18
|
return `message:${turnId ?? 'turn'}:${normalizeOptionalString(itemId) ?? 'latest'}`;
|
|
13
19
|
}
|
|
14
|
-
function buildLiveText(blocks) {
|
|
15
|
-
return blocks
|
|
16
|
-
.filter((block) => block.kind === 'text' && block.text?.trim())
|
|
17
|
-
.sort((left, right) => {
|
|
18
|
-
if (left.sequence !== right.sequence)
|
|
19
|
-
return left.sequence - right.sequence;
|
|
20
|
-
return left.id.localeCompare(right.id);
|
|
21
|
-
})
|
|
22
|
-
.map((block) => block.text)
|
|
23
|
-
.join('\n\n');
|
|
24
|
-
}
|
|
25
|
-
export function applyTextSegmentBlock(state, input) {
|
|
26
|
-
const id = textBlockId(input.turnId, input.itemId);
|
|
27
|
-
const now = input.now ?? Date.now();
|
|
28
|
-
const index = state.turnBlocks.findIndex((block) => block.id === id);
|
|
29
|
-
const existing = index >= 0 ? state.turnBlocks[index] : null;
|
|
30
|
-
const next = {
|
|
31
|
-
...(existing ?? {
|
|
32
|
-
sequence: state.turnBlocks.length + 1,
|
|
33
|
-
createdAt: now,
|
|
34
|
-
}),
|
|
35
|
-
id,
|
|
36
|
-
turnId: input.turnId ?? id,
|
|
37
|
-
kind: 'text',
|
|
38
|
-
status: existing?.status ?? 'running',
|
|
39
|
-
text: input.text,
|
|
40
|
-
updatedAt: now,
|
|
41
|
-
};
|
|
42
|
-
const turnBlocks = index >= 0
|
|
43
|
-
? [
|
|
44
|
-
...state.turnBlocks.slice(0, index),
|
|
45
|
-
next,
|
|
46
|
-
...state.turnBlocks.slice(index + 1),
|
|
47
|
-
]
|
|
48
|
-
: [...state.turnBlocks, next];
|
|
49
|
-
return {
|
|
50
|
-
turnBlocks,
|
|
51
|
-
turnLiveText: buildLiveText(turnBlocks) || state.turnLiveText,
|
|
52
|
-
};
|
|
53
|
-
}
|
|
54
20
|
function nextCommandBlockId(tracker, turnId, itemId) {
|
|
55
21
|
const stableTurnId = turnId ?? 'turn';
|
|
56
22
|
if (itemId)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@canonmsg/codex-plugin",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.19.0",
|
|
4
4
|
"description": "Canon host integration for Codex CLI",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"scripts"
|
|
22
22
|
],
|
|
23
23
|
"scripts": {
|
|
24
|
-
"prepare:workspace-deps": "node ../../scripts/run-workspace-prep.mjs
|
|
24
|
+
"prepare:workspace-deps": "node ../../scripts/run-workspace-prep.mjs ../../packages/core ../../packages/agent-sdk ../../packages/framework ../../packages/bridge ../../packages/agent-host",
|
|
25
25
|
"build": "npm run prepare:workspace-deps && node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc",
|
|
26
26
|
"dev": "npm run prepare:workspace-deps && tsc --watch",
|
|
27
27
|
"smoke": "node scripts/smoke-test.mjs",
|
|
@@ -29,9 +29,12 @@
|
|
|
29
29
|
"prepack": "npm run build"
|
|
30
30
|
},
|
|
31
31
|
"dependencies": {
|
|
32
|
-
"@canonmsg/agent-
|
|
33
|
-
"@canonmsg/
|
|
34
|
-
"@canonmsg/
|
|
32
|
+
"@canonmsg/agent-host": "^0.3.0",
|
|
33
|
+
"@canonmsg/agent-sdk": "^3.4.3",
|
|
34
|
+
"@canonmsg/backend-contracts": "^1.8.0",
|
|
35
|
+
"@canonmsg/bridge": "^0.2.0",
|
|
36
|
+
"@canonmsg/core": "^3.1.0",
|
|
37
|
+
"@canonmsg/framework": "^0.2.0"
|
|
35
38
|
},
|
|
36
39
|
"engines": {
|
|
37
40
|
"node": ">=18.0.0"
|
|
@@ -46,9 +49,9 @@
|
|
|
46
49
|
"repository": {
|
|
47
50
|
"type": "git",
|
|
48
51
|
"url": "https://github.com/HeyBobChan/canon",
|
|
49
|
-
"directory": "
|
|
52
|
+
"directory": "adapters/codex-plugin"
|
|
50
53
|
},
|
|
51
|
-
"homepage": "https://github.com/HeyBobChan/canon/tree/main/
|
|
54
|
+
"homepage": "https://github.com/HeyBobChan/canon/tree/main/adapters/codex-plugin",
|
|
52
55
|
"publishConfig": {
|
|
53
56
|
"access": "public"
|
|
54
57
|
},
|
package/dist/host-lifecycle.d.ts
DELETED
package/dist/host-lifecycle.js
DELETED
package/dist/inbound-policy.d.ts
DELETED
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
import { type CanonGroupContext, type CanonGroupContextMode, type CanonConversation, type ResolvedAgentBehaviorPolicy } from '@canonmsg/core';
|
|
2
|
-
export interface InboundParticipantContext {
|
|
3
|
-
conversationType: CanonConversation['type'] | 'unknown';
|
|
4
|
-
memberCount: number | null;
|
|
5
|
-
senderType: 'human' | 'ai_agent';
|
|
6
|
-
senderName: string;
|
|
7
|
-
isOwner: boolean;
|
|
8
|
-
mentionedAgent: boolean;
|
|
9
|
-
groupContext?: CanonGroupContext;
|
|
10
|
-
groupContextMode?: CanonGroupContextMode;
|
|
11
|
-
recentSenderTypes: Array<'human' | 'ai_agent'>;
|
|
12
|
-
recentHumanCount: number;
|
|
13
|
-
recentAgentCount: number;
|
|
14
|
-
consecutiveAgentTurns: number;
|
|
15
|
-
currentAgentStreakStartedByHuman: boolean;
|
|
16
|
-
}
|
|
17
|
-
export interface AutoReplyDecision {
|
|
18
|
-
allow: boolean;
|
|
19
|
-
reason: string;
|
|
20
|
-
}
|
|
21
|
-
export declare function buildInboundContextLines(context: InboundParticipantContext): string[];
|
|
22
|
-
export declare function decideAutoReply(context: InboundParticipantContext, behavior?: ResolvedAgentBehaviorPolicy | null): AutoReplyDecision;
|
package/dist/inbound-policy.js
DELETED
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
import { buildCompactGroupContextLines, evaluateParticipationPolicy, resolveAgentBehaviorPolicy, } from '@canonmsg/core';
|
|
2
|
-
function formatRecentSenders(senderTypes) {
|
|
3
|
-
if (senderTypes.length === 0)
|
|
4
|
-
return 'none';
|
|
5
|
-
return senderTypes.map((senderType) => (senderType === 'ai_agent' ? 'agent' : 'human')).join(' -> ');
|
|
6
|
-
}
|
|
7
|
-
export function buildInboundContextLines(context) {
|
|
8
|
-
const conversationTypeLabel = context.conversationType === 'unknown'
|
|
9
|
-
? 'unknown'
|
|
10
|
-
: `${context.conversationType}${context.memberCount ? ` (${context.memberCount} members)` : ''}`;
|
|
11
|
-
const senderRole = context.isOwner
|
|
12
|
-
? 'The latest sender is the verified human owner of this Canon agent.'
|
|
13
|
-
: context.senderType === 'ai_agent'
|
|
14
|
-
? 'The latest sender is another AI agent in Canon.'
|
|
15
|
-
: 'The latest sender is a human Canon participant.';
|
|
16
|
-
return [
|
|
17
|
-
senderRole,
|
|
18
|
-
`Latest sender name: ${context.senderName}`,
|
|
19
|
-
`Latest sender type: ${context.senderType}`,
|
|
20
|
-
`Conversation type: ${conversationTypeLabel}`,
|
|
21
|
-
...(context.groupContext && context.groupContextMode
|
|
22
|
-
? buildCompactGroupContextLines(context.groupContext, context.groupContextMode)
|
|
23
|
-
: []),
|
|
24
|
-
`Directly addressed to this agent: ${context.mentionedAgent ? 'yes' : 'no'}`,
|
|
25
|
-
`Recent sender pattern: ${formatRecentSenders(context.recentSenderTypes)}`,
|
|
26
|
-
`Recent human messages: ${context.recentHumanCount}`,
|
|
27
|
-
`Recent agent messages: ${context.recentAgentCount}`,
|
|
28
|
-
`Consecutive recent agent turns: ${context.consecutiveAgentTurns}`,
|
|
29
|
-
`Current agent streak started after a human message: ${context.currentAgentStreakStartedByHuman ? 'yes' : 'no'}`,
|
|
30
|
-
];
|
|
31
|
-
}
|
|
32
|
-
export function decideAutoReply(context, behavior) {
|
|
33
|
-
const decision = evaluateParticipationPolicy(behavior ?? resolveAgentBehaviorPolicy(), {
|
|
34
|
-
conversationType: context.conversationType,
|
|
35
|
-
senderType: context.senderType,
|
|
36
|
-
isOwner: context.isOwner,
|
|
37
|
-
mentionedAgent: context.mentionedAgent,
|
|
38
|
-
recentHumanCount: context.recentHumanCount,
|
|
39
|
-
consecutiveAgentTurns: context.consecutiveAgentTurns,
|
|
40
|
-
currentAgentStreakStartedByHuman: context.currentAgentStreakStartedByHuman,
|
|
41
|
-
});
|
|
42
|
-
return {
|
|
43
|
-
allow: decision.allow,
|
|
44
|
-
reason: decision.reason,
|
|
45
|
-
};
|
|
46
|
-
}
|
|
@@ -1,46 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Startup recovery for inbound messages missed while the host was offline.
|
|
3
|
-
*
|
|
4
|
-
* The host persists a `lastInboundMessageId` cursor per conversation. On
|
|
5
|
-
* startup we paginate `getMessagesPage` (newest-first pages, older pages via
|
|
6
|
-
* its `before` message-id parameter) until the cursor is found or a hard
|
|
7
|
-
* per-conversation bound is hit, then replay everything after the cursor.
|
|
8
|
-
*
|
|
9
|
-
* This module is intentionally identical in packages/claude-code-plugin and
|
|
10
|
-
* packages/codex-plugin — keep both copies in sync (future consolidation
|
|
11
|
-
* candidate).
|
|
12
|
-
*/
|
|
13
|
-
export declare const STARTUP_RECOVERY_PAGE_SIZE = 25;
|
|
14
|
-
export declare const STARTUP_RECOVERY_MAX_MESSAGES = 500;
|
|
15
|
-
export interface StartupRecoveryMessage {
|
|
16
|
-
id: string;
|
|
17
|
-
senderId: string;
|
|
18
|
-
createdAt?: string;
|
|
19
|
-
}
|
|
20
|
-
export interface StartupRecoveryPage {
|
|
21
|
-
messages: StartupRecoveryMessage[];
|
|
22
|
-
}
|
|
23
|
-
export type StartupRecoveryMode =
|
|
24
|
-
/** Cursor found — `messages` is everything strictly after it. */
|
|
25
|
-
'after-cursor'
|
|
26
|
-
/** Cursor present but not found within the bound — `messages` is the bounded recent window. */
|
|
27
|
-
| 'truncated-window'
|
|
28
|
-
/**
|
|
29
|
-
* No usable cursor (fresh runtime file, or the cursor message no longer
|
|
30
|
-
* exists in history) — only the newest inbound message is recovered, since
|
|
31
|
-
* a full-history replay could fire mass duplicate turns.
|
|
32
|
-
*/
|
|
33
|
-
| 'latest-only';
|
|
34
|
-
export interface StartupRecoveryResult<TPage extends StartupRecoveryPage> {
|
|
35
|
-
mode: StartupRecoveryMode;
|
|
36
|
-
/** Missed inbound messages (own messages excluded), oldest first. */
|
|
37
|
-
messages: TPage['messages'];
|
|
38
|
-
/** First page fetched — reusable as hydration context for recovered turns. */
|
|
39
|
-
newestPage: TPage;
|
|
40
|
-
}
|
|
41
|
-
export declare function collectMissedInboundMessages<TPage extends StartupRecoveryPage>(input: {
|
|
42
|
-
fetchPage: (before?: string) => Promise<TPage>;
|
|
43
|
-
cursor: string | null | undefined;
|
|
44
|
-
agentId: string;
|
|
45
|
-
maxMessages?: number;
|
|
46
|
-
}): Promise<StartupRecoveryResult<TPage>>;
|
package/dist/startup-recovery.js
DELETED
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Startup recovery for inbound messages missed while the host was offline.
|
|
3
|
-
*
|
|
4
|
-
* The host persists a `lastInboundMessageId` cursor per conversation. On
|
|
5
|
-
* startup we paginate `getMessagesPage` (newest-first pages, older pages via
|
|
6
|
-
* its `before` message-id parameter) until the cursor is found or a hard
|
|
7
|
-
* per-conversation bound is hit, then replay everything after the cursor.
|
|
8
|
-
*
|
|
9
|
-
* This module is intentionally identical in packages/claude-code-plugin and
|
|
10
|
-
* packages/codex-plugin — keep both copies in sync (future consolidation
|
|
11
|
-
* candidate).
|
|
12
|
-
*/
|
|
13
|
-
export const STARTUP_RECOVERY_PAGE_SIZE = 25;
|
|
14
|
-
export const STARTUP_RECOVERY_MAX_MESSAGES = 500;
|
|
15
|
-
export async function collectMissedInboundMessages(input) {
|
|
16
|
-
const maxMessages = input.maxMessages ?? STARTUP_RECOVERY_MAX_MESSAGES;
|
|
17
|
-
const newestPage = await input.fetchPage();
|
|
18
|
-
const collected = [...newestPage.messages];
|
|
19
|
-
const seenIds = new Set(collected.map((message) => message.id));
|
|
20
|
-
const hasCursor = (messages) => input.cursor != null && messages.some((message) => message.id === input.cursor);
|
|
21
|
-
let cursorFound = hasCursor(collected);
|
|
22
|
-
if (input.cursor != null) {
|
|
23
|
-
while (!cursorFound && collected.length < maxMessages) {
|
|
24
|
-
// Pages are newest-first, so the last collected message is the oldest.
|
|
25
|
-
const before = collected[collected.length - 1]?.id;
|
|
26
|
-
if (!before)
|
|
27
|
-
break;
|
|
28
|
-
const page = await input.fetchPage(before);
|
|
29
|
-
const fresh = page.messages.filter((message) => !seenIds.has(message.id));
|
|
30
|
-
// No pagination progress (history exhausted, or the server ignored the
|
|
31
|
-
// `before` cursor because that message was hard-deleted) — stop here.
|
|
32
|
-
if (fresh.length === 0)
|
|
33
|
-
break;
|
|
34
|
-
for (const message of fresh)
|
|
35
|
-
seenIds.add(message.id);
|
|
36
|
-
collected.push(...fresh);
|
|
37
|
-
cursorFound = hasCursor(fresh);
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
|
-
const ascending = [...collected].sort((a, b) => String(a.createdAt ?? '').localeCompare(String(b.createdAt ?? '')));
|
|
41
|
-
const inboundOnly = (messages) => messages.filter((message) => message.senderId !== input.agentId);
|
|
42
|
-
let mode;
|
|
43
|
-
let missed;
|
|
44
|
-
if (cursorFound) {
|
|
45
|
-
const cursorIndex = ascending.findIndex((message) => message.id === input.cursor);
|
|
46
|
-
mode = 'after-cursor';
|
|
47
|
-
missed = inboundOnly(ascending.slice(cursorIndex + 1));
|
|
48
|
-
}
|
|
49
|
-
else if (input.cursor != null && collected.length >= maxMessages) {
|
|
50
|
-
mode = 'truncated-window';
|
|
51
|
-
missed = inboundOnly(ascending.slice(-maxMessages));
|
|
52
|
-
}
|
|
53
|
-
else {
|
|
54
|
-
mode = 'latest-only';
|
|
55
|
-
missed = inboundOnly(ascending).slice(-1);
|
|
56
|
-
}
|
|
57
|
-
// Safe: `missed` only holds elements of pages returned by `fetchPage`.
|
|
58
|
-
return { mode, messages: missed, newestPage };
|
|
59
|
-
}
|