@njuptlzf/agent-chat-server 0.2.0 → 0.3.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.
@@ -19,152 +19,152 @@ import { GENESIS_HASH, assertNoSensitiveKeys, canonicalize, rowHash, segmentsFro
19
19
  */
20
20
  export function openDatabase(file, defaultScope = "", defaultPersona = DEFAULT_PERSONA_ID) {
21
21
  const db = new DatabaseSync(file);
22
- db.exec(`
23
- PRAGMA journal_mode = WAL;
24
- CREATE TABLE IF NOT EXISTS history (
25
- user_id TEXT NOT NULL,
26
- scope TEXT NOT NULL DEFAULT '',
27
- session_id TEXT NOT NULL,
28
- entries TEXT NOT NULL,
29
- updated_at TEXT NOT NULL,
30
- -- 人格:可空 = 未绑定(新会话、或更早的老行)。
31
- -- 不进主键 ⇒ 老库 ALTER ADD COLUMN 就够,不用重建(scope 当年要重建是因为它进了主键)。
32
- persona TEXT,
33
- -- 建会话时生效的人格配置版本;0 = manifest,NULL = 更早的老行(不编历史)。
34
- persona_version INTEGER,
35
- PRIMARY KEY (user_id, scope, session_id)
36
- );
37
- -- persona 进主键:各个人格各算各的。老库由 migrateScope 重建。
38
- -- **不给列默认值**:账本键必须显式写入,core 不发明任何人格 id。
39
- CREATE TABLE IF NOT EXISTS quota (
40
- user_id TEXT NOT NULL,
41
- persona TEXT NOT NULL,
42
- day TEXT NOT NULL,
43
- tokens INTEGER NOT NULL,
44
- PRIMARY KEY (user_id, persona, day)
45
- );
46
- CREATE TABLE IF NOT EXISTS runs (
47
- id INTEGER PRIMARY KEY AUTOINCREMENT,
48
- user_id TEXT NOT NULL,
49
- session_id TEXT NOT NULL,
50
- product TEXT NOT NULL,
51
- started_at TEXT NOT NULL,
52
- duration_ms INTEGER NOT NULL,
53
- tool_rounds INTEGER NOT NULL,
54
- aborted INTEGER NOT NULL,
55
- tokens INTEGER NOT NULL,
56
- cost_usd REAL NOT NULL,
57
- error TEXT
58
- );
59
- CREATE INDEX IF NOT EXISTS runs_user_day ON runs (user_id, started_at);
60
- CREATE TABLE IF NOT EXISTS billing_balance (
61
- user_id TEXT PRIMARY KEY,
62
- balance INTEGER NOT NULL DEFAULT 0
63
- );
64
- CREATE TABLE IF NOT EXISTS billing_ledger (
65
- id INTEGER PRIMARY KEY AUTOINCREMENT,
66
- user_id TEXT NOT NULL,
67
- at TEXT NOT NULL,
68
- kind TEXT NOT NULL,
69
- amount_cents INTEGER NOT NULL,
70
- balance_after INTEGER NOT NULL,
71
- ref TEXT
72
- );
73
- CREATE TABLE IF NOT EXISTS billing_orders (
74
- id TEXT PRIMARY KEY,
75
- user_id TEXT NOT NULL,
76
- amount_cents INTEGER NOT NULL,
77
- status TEXT NOT NULL,
78
- -- 下单时间。没有它,「钱到账没」只能回一个 pending/paid,
79
- -- 模型没法说「这笔是刚下的、还在处理」。老库由下方幂等 ALTER 补列(值留空)。
80
- created_at TEXT,
81
- -- 订单品类与产品(分开买)。老行一律 recharge + product NULL + days NULL。
82
- kind TEXT NOT NULL DEFAULT 'recharge',
83
- product TEXT,
84
- days INTEGER
85
- );
86
- CREATE INDEX IF NOT EXISTS billing_ledger_user ON billing_ledger (user_id, id);
87
- CREATE TABLE IF NOT EXISTS feedback (
88
- id INTEGER PRIMARY KEY AUTOINCREMENT,
89
- at TEXT NOT NULL,
90
- user_id TEXT NOT NULL,
91
- session_id TEXT NOT NULL,
92
- -- rating 行写 up/down;工单行写 'none'(列是 NOT NULL,工单本来就没有赞/踩)
93
- rating TEXT NOT NULL,
94
- ref TEXT,
95
- priority TEXT NOT NULL DEFAULT 'normal',
96
- -- 反馈分两条腿——rating(信号)与四种工单(有正文/状态/处理人)
97
- kind TEXT NOT NULL DEFAULT 'rating',
98
- content TEXT,
99
- status TEXT NOT NULL DEFAULT 'new',
100
- reply TEXT,
101
- handled_by TEXT,
102
- handled_at TEXT,
103
- reward_days INTEGER
104
- );
105
- CREATE INDEX IF NOT EXISTS feedback_at ON feedback (id);
106
- -- 权限内核:casbin 标准策略表,管理页可编辑的「策略即数据」。
107
- CREATE TABLE IF NOT EXISTS casbin_rule (
108
- id INTEGER PRIMARY KEY AUTOINCREMENT,
109
- ptype TEXT NOT NULL,
110
- v0 TEXT NOT NULL DEFAULT '',
111
- v1 TEXT NOT NULL DEFAULT '',
112
- v2 TEXT NOT NULL DEFAULT '',
113
- v3 TEXT NOT NULL DEFAULT '',
114
- v4 TEXT NOT NULL DEFAULT '',
115
- v5 TEXT NOT NULL DEFAULT ''
116
- );
117
- CREATE UNIQUE INDEX IF NOT EXISTS casbin_rule_uniq ON casbin_rule (ptype, v0, v1, v2, v3, v4, v5);
118
- -- 会员 = 订阅制有效期,与余额解耦。member 角色由这张表现算,不进 g 表。
119
- -- 会员按**产品(= 人格 id)**分账(分开买)。product 进主键 ⇒ 老库由
120
- -- migrateProductDimension 重建;新库直接是新形状。
121
- CREATE TABLE IF NOT EXISTS membership (
122
- user_id TEXT NOT NULL,
123
- product TEXT NOT NULL,
124
- member_until TEXT NOT NULL,
125
- granted_by TEXT,
126
- updated_at TEXT NOT NULL,
127
- PRIMARY KEY (user_id, product)
128
- );
129
- -- 封号 = 身份闸,先于 casbin;付费与否同规。
130
- -- audit_revoked:审计可见性取消名单——登录默认全开,admin 可按用户取消。
131
- CREATE TABLE IF NOT EXISTS account_state (
132
- user_id TEXT PRIMARY KEY,
133
- banned_until TEXT,
134
- reason TEXT,
135
- audit_revoked INTEGER NOT NULL DEFAULT 0,
136
- -- 序列 4:上次「看过每日总结」的时刻(ISO)。存这里而不是 localStorage——
137
- -- 换设备要能记住(V6b 那条教训)。
138
- last_digest_at TEXT,
139
- updated_at TEXT NOT NULL
140
- );
141
- -- 会员月度池:池内 token 不产生余额账;(user,月) 一行,lazy 发满。
142
- -- 每月 token 池也按产品拆(不拆的话一个产品会把另一个的池用光)。
143
- CREATE TABLE IF NOT EXISTS member_pool (
144
- user_id TEXT NOT NULL,
145
- product TEXT NOT NULL,
146
- month TEXT NOT NULL,
147
- granted INTEGER NOT NULL,
148
- used INTEGER NOT NULL DEFAULT 0,
149
- PRIMARY KEY (user_id, product, month)
150
- );
151
- -- 审计与操作留痕:append-only 哈希链,全库唯一「读时也验」的表。
152
- CREATE TABLE IF NOT EXISTS audit_log (
153
- id INTEGER PRIMARY KEY AUTOINCREMENT,
154
- at TEXT NOT NULL,
155
- actor TEXT NOT NULL,
156
- roles TEXT NOT NULL DEFAULT '[]',
157
- action TEXT NOT NULL,
158
- target TEXT,
159
- result TEXT NOT NULL,
160
- reason TEXT,
161
- meta TEXT NOT NULL DEFAULT '{}',
162
- prev_hash TEXT NOT NULL,
163
- hash TEXT NOT NULL
164
- );
165
- CREATE INDEX IF NOT EXISTS audit_at ON audit_log (at);
166
- CREATE INDEX IF NOT EXISTS audit_action ON audit_log (action, id);
167
- CREATE INDEX IF NOT EXISTS audit_actor ON audit_log (actor, id);
22
+ db.exec(`
23
+ PRAGMA journal_mode = WAL;
24
+ CREATE TABLE IF NOT EXISTS history (
25
+ user_id TEXT NOT NULL,
26
+ scope TEXT NOT NULL DEFAULT '',
27
+ session_id TEXT NOT NULL,
28
+ entries TEXT NOT NULL,
29
+ updated_at TEXT NOT NULL,
30
+ -- 人格:可空 = 未绑定(新会话、或更早的老行)。
31
+ -- 不进主键 ⇒ 老库 ALTER ADD COLUMN 就够,不用重建(scope 当年要重建是因为它进了主键)。
32
+ persona TEXT,
33
+ -- 建会话时生效的人格配置版本;0 = manifest,NULL = 更早的老行(不编历史)。
34
+ persona_version INTEGER,
35
+ PRIMARY KEY (user_id, scope, session_id)
36
+ );
37
+ -- persona 进主键:各个人格各算各的。老库由 migrateScope 重建。
38
+ -- **不给列默认值**:账本键必须显式写入,core 不发明任何人格 id。
39
+ CREATE TABLE IF NOT EXISTS quota (
40
+ user_id TEXT NOT NULL,
41
+ persona TEXT NOT NULL,
42
+ day TEXT NOT NULL,
43
+ tokens INTEGER NOT NULL,
44
+ PRIMARY KEY (user_id, persona, day)
45
+ );
46
+ CREATE TABLE IF NOT EXISTS runs (
47
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
48
+ user_id TEXT NOT NULL,
49
+ session_id TEXT NOT NULL,
50
+ product TEXT NOT NULL,
51
+ started_at TEXT NOT NULL,
52
+ duration_ms INTEGER NOT NULL,
53
+ tool_rounds INTEGER NOT NULL,
54
+ aborted INTEGER NOT NULL,
55
+ tokens INTEGER NOT NULL,
56
+ cost_usd REAL NOT NULL,
57
+ error TEXT
58
+ );
59
+ CREATE INDEX IF NOT EXISTS runs_user_day ON runs (user_id, started_at);
60
+ CREATE TABLE IF NOT EXISTS billing_balance (
61
+ user_id TEXT PRIMARY KEY,
62
+ balance INTEGER NOT NULL DEFAULT 0
63
+ );
64
+ CREATE TABLE IF NOT EXISTS billing_ledger (
65
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
66
+ user_id TEXT NOT NULL,
67
+ at TEXT NOT NULL,
68
+ kind TEXT NOT NULL,
69
+ amount_cents INTEGER NOT NULL,
70
+ balance_after INTEGER NOT NULL,
71
+ ref TEXT
72
+ );
73
+ CREATE TABLE IF NOT EXISTS billing_orders (
74
+ id TEXT PRIMARY KEY,
75
+ user_id TEXT NOT NULL,
76
+ amount_cents INTEGER NOT NULL,
77
+ status TEXT NOT NULL,
78
+ -- 下单时间。没有它,「钱到账没」只能回一个 pending/paid,
79
+ -- 模型没法说「这笔是刚下的、还在处理」。老库由下方幂等 ALTER 补列(值留空)。
80
+ created_at TEXT,
81
+ -- 订单品类与产品(分开买)。老行一律 recharge + product NULL + days NULL。
82
+ kind TEXT NOT NULL DEFAULT 'recharge',
83
+ product TEXT,
84
+ days INTEGER
85
+ );
86
+ CREATE INDEX IF NOT EXISTS billing_ledger_user ON billing_ledger (user_id, id);
87
+ CREATE TABLE IF NOT EXISTS feedback (
88
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
89
+ at TEXT NOT NULL,
90
+ user_id TEXT NOT NULL,
91
+ session_id TEXT NOT NULL,
92
+ -- rating 行写 up/down;工单行写 'none'(列是 NOT NULL,工单本来就没有赞/踩)
93
+ rating TEXT NOT NULL,
94
+ ref TEXT,
95
+ priority TEXT NOT NULL DEFAULT 'normal',
96
+ -- 反馈分两条腿——rating(信号)与四种工单(有正文/状态/处理人)
97
+ kind TEXT NOT NULL DEFAULT 'rating',
98
+ content TEXT,
99
+ status TEXT NOT NULL DEFAULT 'new',
100
+ reply TEXT,
101
+ handled_by TEXT,
102
+ handled_at TEXT,
103
+ reward_days INTEGER
104
+ );
105
+ CREATE INDEX IF NOT EXISTS feedback_at ON feedback (id);
106
+ -- 权限内核:casbin 标准策略表,管理页可编辑的「策略即数据」。
107
+ CREATE TABLE IF NOT EXISTS casbin_rule (
108
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
109
+ ptype TEXT NOT NULL,
110
+ v0 TEXT NOT NULL DEFAULT '',
111
+ v1 TEXT NOT NULL DEFAULT '',
112
+ v2 TEXT NOT NULL DEFAULT '',
113
+ v3 TEXT NOT NULL DEFAULT '',
114
+ v4 TEXT NOT NULL DEFAULT '',
115
+ v5 TEXT NOT NULL DEFAULT ''
116
+ );
117
+ CREATE UNIQUE INDEX IF NOT EXISTS casbin_rule_uniq ON casbin_rule (ptype, v0, v1, v2, v3, v4, v5);
118
+ -- 会员 = 订阅制有效期,与余额解耦。member 角色由这张表现算,不进 g 表。
119
+ -- 会员按**产品(= 人格 id)**分账(分开买)。product 进主键 ⇒ 老库由
120
+ -- migrateProductDimension 重建;新库直接是新形状。
121
+ CREATE TABLE IF NOT EXISTS membership (
122
+ user_id TEXT NOT NULL,
123
+ product TEXT NOT NULL,
124
+ member_until TEXT NOT NULL,
125
+ granted_by TEXT,
126
+ updated_at TEXT NOT NULL,
127
+ PRIMARY KEY (user_id, product)
128
+ );
129
+ -- 封号 = 身份闸,先于 casbin;付费与否同规。
130
+ -- audit_revoked:审计可见性取消名单——登录默认全开,admin 可按用户取消。
131
+ CREATE TABLE IF NOT EXISTS account_state (
132
+ user_id TEXT PRIMARY KEY,
133
+ banned_until TEXT,
134
+ reason TEXT,
135
+ audit_revoked INTEGER NOT NULL DEFAULT 0,
136
+ -- 序列 4:上次「看过每日总结」的时刻(ISO)。存这里而不是 localStorage——
137
+ -- 换设备要能记住(V6b 那条教训)。
138
+ last_digest_at TEXT,
139
+ updated_at TEXT NOT NULL
140
+ );
141
+ -- 会员月度池:池内 token 不产生余额账;(user,月) 一行,lazy 发满。
142
+ -- 每月 token 池也按产品拆(不拆的话一个产品会把另一个的池用光)。
143
+ CREATE TABLE IF NOT EXISTS member_pool (
144
+ user_id TEXT NOT NULL,
145
+ product TEXT NOT NULL,
146
+ month TEXT NOT NULL,
147
+ granted INTEGER NOT NULL,
148
+ used INTEGER NOT NULL DEFAULT 0,
149
+ PRIMARY KEY (user_id, product, month)
150
+ );
151
+ -- 审计与操作留痕:append-only 哈希链,全库唯一「读时也验」的表。
152
+ CREATE TABLE IF NOT EXISTS audit_log (
153
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
154
+ at TEXT NOT NULL,
155
+ actor TEXT NOT NULL,
156
+ roles TEXT NOT NULL DEFAULT '[]',
157
+ action TEXT NOT NULL,
158
+ target TEXT,
159
+ result TEXT NOT NULL,
160
+ reason TEXT,
161
+ meta TEXT NOT NULL DEFAULT '{}',
162
+ prev_hash TEXT NOT NULL,
163
+ hash TEXT NOT NULL
164
+ );
165
+ CREATE INDEX IF NOT EXISTS audit_at ON audit_log (at);
166
+ CREATE INDEX IF NOT EXISTS audit_action ON audit_log (action, id);
167
+ CREATE INDEX IF NOT EXISTS audit_actor ON audit_log (actor, id);
168
168
  `);
169
169
  migrateScope(db, defaultScope, defaultPersona);
170
170
  return db;
@@ -185,39 +185,39 @@ function migrateScope(db, defaultScope, defaultPersona) {
185
185
  const personaOfDefault = defaultPersona.replace(/'/g, "''");
186
186
  // quota 主键要加 persona,只能重建(同 history 的 v6 做法)。
187
187
  if (!columns("quota").includes("persona")) {
188
- db.exec(`
189
- BEGIN;
190
- CREATE TABLE quota_v7 (
191
- user_id TEXT NOT NULL,
192
- persona TEXT NOT NULL,
193
- day TEXT NOT NULL,
194
- tokens INTEGER NOT NULL,
195
- PRIMARY KEY (user_id, persona, day)
196
- );
197
- INSERT INTO quota_v7 (user_id, persona, day, tokens)
198
- SELECT user_id, '${personaOfDefault}', day, tokens FROM quota;
199
- DROP TABLE quota;
200
- ALTER TABLE quota_v7 RENAME TO quota;
201
- COMMIT;
188
+ db.exec(`
189
+ BEGIN;
190
+ CREATE TABLE quota_v7 (
191
+ user_id TEXT NOT NULL,
192
+ persona TEXT NOT NULL,
193
+ day TEXT NOT NULL,
194
+ tokens INTEGER NOT NULL,
195
+ PRIMARY KEY (user_id, persona, day)
196
+ );
197
+ INSERT INTO quota_v7 (user_id, persona, day, tokens)
198
+ SELECT user_id, '${personaOfDefault}', day, tokens FROM quota;
199
+ DROP TABLE quota;
200
+ ALTER TABLE quota_v7 RENAME TO quota;
201
+ COMMIT;
202
202
  `);
203
203
  }
204
204
  if (!columns("history").includes("scope")) {
205
- db.exec(`
206
- BEGIN;
207
- ALTER TABLE history RENAME TO history_v6;
208
- CREATE TABLE history (
209
- user_id TEXT NOT NULL,
210
- scope TEXT NOT NULL DEFAULT '',
211
- session_id TEXT NOT NULL,
212
- entries TEXT NOT NULL,
213
- updated_at TEXT NOT NULL,
214
- persona TEXT,
215
- PRIMARY KEY (user_id, scope, session_id)
216
- );
217
- INSERT INTO history (user_id, scope, session_id, entries, updated_at)
218
- SELECT user_id, '${scopeOfDefault.replace(/'/g, "''")}', session_id, entries, updated_at FROM history_v6;
219
- DROP TABLE history_v6;
220
- COMMIT;
205
+ db.exec(`
206
+ BEGIN;
207
+ ALTER TABLE history RENAME TO history_v6;
208
+ CREATE TABLE history (
209
+ user_id TEXT NOT NULL,
210
+ scope TEXT NOT NULL DEFAULT '',
211
+ session_id TEXT NOT NULL,
212
+ entries TEXT NOT NULL,
213
+ updated_at TEXT NOT NULL,
214
+ persona TEXT,
215
+ PRIMARY KEY (user_id, scope, session_id)
216
+ );
217
+ INSERT INTO history (user_id, scope, session_id, entries, updated_at)
218
+ SELECT user_id, '${scopeOfDefault.replace(/'/g, "''")}', session_id, entries, updated_at FROM history_v6;
219
+ DROP TABLE history_v6;
220
+ COMMIT;
221
221
  `);
222
222
  }
223
223
  // 会员权益:反馈分处理优先级(会员=high,report 置顶)。「会员优先」是
@@ -310,23 +310,23 @@ export function migrateProductDimension(db, defaultPersona) {
310
310
  }
311
311
  report.rebuilt.push(table);
312
312
  };
313
- rebuild("membership", `CREATE TABLE membership_(
314
- user_id TEXT NOT NULL,
315
- product TEXT NOT NULL DEFAULT '${product}',
316
- member_until TEXT NOT NULL,
317
- granted_by TEXT,
318
- updated_at TEXT NOT NULL,
319
- PRIMARY KEY (user_id, product)
320
- )`, `INSERT INTO membership_(user_id, product, member_until, granted_by, updated_at)
313
+ rebuild("membership", `CREATE TABLE membership_(
314
+ user_id TEXT NOT NULL,
315
+ product TEXT NOT NULL DEFAULT '${product}',
316
+ member_until TEXT NOT NULL,
317
+ granted_by TEXT,
318
+ updated_at TEXT NOT NULL,
319
+ PRIMARY KEY (user_id, product)
320
+ )`, `INSERT INTO membership_(user_id, product, member_until, granted_by, updated_at)
321
321
  SELECT user_id, '${product}', member_until, granted_by, updated_at FROM membership`);
322
- rebuild("member_pool", `CREATE TABLE member_pool_(
323
- user_id TEXT NOT NULL,
324
- product TEXT NOT NULL DEFAULT '${product}',
325
- month TEXT NOT NULL,
326
- granted INTEGER NOT NULL,
327
- used INTEGER NOT NULL DEFAULT 0,
328
- PRIMARY KEY (user_id, product, month)
329
- )`, `INSERT INTO member_pool_(user_id, product, month, granted, used)
322
+ rebuild("member_pool", `CREATE TABLE member_pool_(
323
+ user_id TEXT NOT NULL,
324
+ product TEXT NOT NULL DEFAULT '${product}',
325
+ month TEXT NOT NULL,
326
+ granted INTEGER NOT NULL,
327
+ used INTEGER NOT NULL DEFAULT 0,
328
+ PRIMARY KEY (user_id, product, month)
329
+ )`, `INSERT INTO member_pool_(user_id, product, month, granted, used)
330
330
  SELECT user_id, '${product}', month, granted, used FROM member_pool`);
331
331
  const add = (table, column, ddl) => {
332
332
  if (!exists(table) || columns(table).includes(column))
@@ -356,13 +356,13 @@ export class SqliteHistoryStore {
356
356
  }
357
357
  async save(userId, scope, sessionId, entries, persona, personaVersion) {
358
358
  this.db
359
- .prepare(`INSERT INTO history (user_id, scope, session_id, entries, updated_at, persona, persona_version) VALUES (?, ?, ?, ?, ?, ?, ?)
360
- ON CONFLICT (user_id, scope, session_id) DO UPDATE
361
- SET entries = excluded.entries,
362
- updated_at = excluded.updated_at,
363
- -- 首次绑定后不再改写:中途换人格该由端点拦(persona_mismatch),这里是第二道。
364
- persona = COALESCE(history.persona, excluded.persona),
365
- -- 版本与人格同一生命周期:第一轮落库那一刻定死,之后改配置也不追认。
359
+ .prepare(`INSERT INTO history (user_id, scope, session_id, entries, updated_at, persona, persona_version) VALUES (?, ?, ?, ?, ?, ?, ?)
360
+ ON CONFLICT (user_id, scope, session_id) DO UPDATE
361
+ SET entries = excluded.entries,
362
+ updated_at = excluded.updated_at,
363
+ -- 首次绑定后不再改写:中途换人格该由端点拦(persona_mismatch),这里是第二道。
364
+ persona = COALESCE(history.persona, excluded.persona),
365
+ -- 版本与人格同一生命周期:第一轮落库那一刻定死,之后改配置也不追认。
366
366
  persona_version = COALESCE(history.persona_version, excluded.persona_version)`)
367
367
  .run(userId, scope, sessionId, JSON.stringify(entries), new Date().toISOString(), persona ?? null, personaVersion ?? null);
368
368
  }
@@ -438,7 +438,7 @@ export class SqliteQuotaGate {
438
438
  }
439
439
  async record(userId, usage, persona) {
440
440
  this.db
441
- .prepare(`INSERT INTO quota (user_id, persona, day, tokens) VALUES (?, ?, ?, ?)
441
+ .prepare(`INSERT INTO quota (user_id, persona, day, tokens) VALUES (?, ?, ?, ?)
442
442
  ON CONFLICT (user_id, persona, day) DO UPDATE SET tokens = tokens + excluded.tokens`)
443
443
  .run(userId, persona, this.day(), usage.total);
444
444
  }
@@ -457,8 +457,8 @@ export class SqliteMembership {
457
457
  async set(userId, product, memberUntil, grantedBy) {
458
458
  assertMembershipWrite(product, memberUntil);
459
459
  this.db
460
- .prepare(`INSERT INTO membership (user_id, product, member_until, granted_by, updated_at) VALUES (?, ?, ?, ?, ?)
461
- ON CONFLICT (user_id, product) DO UPDATE SET member_until = excluded.member_until,
460
+ .prepare(`INSERT INTO membership (user_id, product, member_until, granted_by, updated_at) VALUES (?, ?, ?, ?, ?)
461
+ ON CONFLICT (user_id, product) DO UPDATE SET member_until = excluded.member_until,
462
462
  granted_by = excluded.granted_by, updated_at = excluded.updated_at`)
463
463
  .run(userId, product, memberUntil, grantedBy ?? null, new Date().toISOString());
464
464
  }
@@ -474,12 +474,12 @@ export class SqliteMembership {
474
474
  throw new Error(`membership days must be a positive integer, got ${days}`);
475
475
  const now = new Date().toISOString();
476
476
  const row = this.db
477
- .prepare(`INSERT INTO membership (user_id, product, member_until, granted_by, updated_at)
478
- VALUES (?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', ?, '+' || ? || ' days'), ?, ?)
479
- ON CONFLICT (user_id, product) DO UPDATE SET
480
- member_until = strftime('%Y-%m-%dT%H:%M:%fZ', MAX(membership.member_until, ?), '+' || ? || ' days'),
481
- granted_by = excluded.granted_by,
482
- updated_at = excluded.updated_at
477
+ .prepare(`INSERT INTO membership (user_id, product, member_until, granted_by, updated_at)
478
+ VALUES (?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', ?, '+' || ? || ' days'), ?, ?)
479
+ ON CONFLICT (user_id, product) DO UPDATE SET
480
+ member_until = strftime('%Y-%m-%dT%H:%M:%fZ', MAX(membership.member_until, ?), '+' || ? || ' days'),
481
+ granted_by = excluded.granted_by,
482
+ updated_at = excluded.updated_at
483
483
  RETURNING member_until`)
484
484
  .get(userId, product, now, days, grantedBy ?? null, now, now, days);
485
485
  return row.member_until;
@@ -524,14 +524,14 @@ export class SqliteAccountState {
524
524
  }
525
525
  async setBan(userId, bannedUntil, reason) {
526
526
  this.db
527
- .prepare(`INSERT INTO account_state (user_id, banned_until, reason, updated_at) VALUES (?, ?, ?, ?)
528
- ON CONFLICT (user_id) DO UPDATE SET banned_until = excluded.banned_until,
527
+ .prepare(`INSERT INTO account_state (user_id, banned_until, reason, updated_at) VALUES (?, ?, ?, ?)
528
+ ON CONFLICT (user_id) DO UPDATE SET banned_until = excluded.banned_until,
529
529
  reason = excluded.reason, updated_at = excluded.updated_at`)
530
530
  .run(userId, bannedUntil, reason, new Date().toISOString());
531
531
  }
532
532
  async removeBan(userId) {
533
533
  this.db
534
- .prepare(`INSERT INTO account_state (user_id, banned_until, reason, updated_at) VALUES (?, NULL, NULL, ?)
534
+ .prepare(`INSERT INTO account_state (user_id, banned_until, reason, updated_at) VALUES (?, NULL, NULL, ?)
535
535
  ON CONFLICT (user_id) DO UPDATE SET banned_until = NULL, reason = NULL, updated_at = excluded.updated_at`)
536
536
  .run(userId, new Date().toISOString());
537
537
  }
@@ -541,7 +541,7 @@ export class SqliteAccountState {
541
541
  }
542
542
  async setAuditRevoked(userId, revoked) {
543
543
  this.db
544
- .prepare(`INSERT INTO account_state (user_id, audit_revoked, updated_at) VALUES (?, ?, ?)
544
+ .prepare(`INSERT INTO account_state (user_id, audit_revoked, updated_at) VALUES (?, ?, ?)
545
545
  ON CONFLICT (user_id) DO UPDATE SET audit_revoked = excluded.audit_revoked, updated_at = excluded.updated_at`)
546
546
  .run(userId, revoked ? 1 : 0, new Date().toISOString());
547
547
  }
@@ -551,7 +551,7 @@ export class SqliteAccountState {
551
551
  }
552
552
  async markDigestSeen(userId, at) {
553
553
  this.db
554
- .prepare(`INSERT INTO account_state (user_id, last_digest_at, updated_at) VALUES (?, ?, ?)
554
+ .prepare(`INSERT INTO account_state (user_id, last_digest_at, updated_at) VALUES (?, ?, ?)
555
555
  ON CONFLICT (user_id) DO UPDATE SET last_digest_at = excluded.last_digest_at, updated_at = excluded.updated_at`)
556
556
  .run(userId, at, new Date().toISOString());
557
557
  }
@@ -598,7 +598,7 @@ export class SqliteRunLog {
598
598
  }
599
599
  async record(run) {
600
600
  this.db
601
- .prepare(`INSERT INTO runs (user_id, session_id, product, persona, started_at, duration_ms, tool_rounds, aborted, tokens, cost_usd, error)
601
+ .prepare(`INSERT INTO runs (user_id, session_id, product, persona, started_at, duration_ms, tool_rounds, aborted, tokens, cost_usd, error)
602
602
  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
603
603
  .run(run.userId, run.sessionId, run.product, run.persona, run.startedAt, run.durationMs, run.toolRounds, run.aborted ? 1 : 0, run.usage.total, run.usage.costUsd, run.error ?? null);
604
604
  }
@@ -678,8 +678,8 @@ export class SqliteBilling {
678
678
  return gated.balance;
679
679
  }
680
680
  const { balance } = this.db
681
- .prepare(`INSERT INTO billing_balance (user_id, balance) VALUES (?, ?)
682
- ON CONFLICT (user_id) DO UPDATE SET balance = balance + excluded.balance
681
+ .prepare(`INSERT INTO billing_balance (user_id, balance) VALUES (?, ?)
682
+ ON CONFLICT (user_id) DO UPDATE SET balance = balance + excluded.balance
683
683
  RETURNING balance`)
684
684
  .get(userId, deltaCents);
685
685
  this.db
@@ -702,7 +702,7 @@ export class SqliteBilling {
702
702
  async createOrder(userId, amountCents, meta = {}) {
703
703
  const id = `ord_${randomUUID().slice(0, 8)}`;
704
704
  this.db
705
- .prepare(`INSERT INTO billing_orders (id, user_id, amount_cents, status, created_at, kind, product, days)
705
+ .prepare(`INSERT INTO billing_orders (id, user_id, amount_cents, status, created_at, kind, product, days)
706
706
  VALUES (?, ?, ?, 'pending', ?, ?, ?, ?)`)
707
707
  .run(id, userId, amountCents, new Date().toISOString(), meta.kind ?? "recharge", meta.product ?? null, meta.days ?? null);
708
708
  return id;
@@ -848,7 +848,7 @@ export class SqliteAudit {
848
848
  const last = this.db.prepare("SELECT hash FROM audit_log ORDER BY id DESC LIMIT 1").get();
849
849
  const prevHash = last?.hash ?? GENESIS_HASH;
850
850
  const info = this.db
851
- .prepare(`INSERT INTO audit_log (at, actor, roles, action, target, result, reason, meta, prev_hash, hash)
851
+ .prepare(`INSERT INTO audit_log (at, actor, roles, action, target, result, reason, meta, prev_hash, hash)
852
852
  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
853
853
  .run(body.at, body.actor, canonicalize(body.roles), body.action, body.target, body.result, body.reason, canonicalize(body.meta), prevHash, rowHash(prevHash, body));
854
854
  return Number(info.lastInsertRowid);
@@ -0,0 +1,60 @@
1
+ /**
2
+ * 「下一步建议」的生成层:一轮对话结束后,把最近的**文本**消息拍平交给产品
3
+ * 默认模型,产出 N 条用户可能发出的简短追问。
4
+ *
5
+ * 定位与 `persona-trial` 不同:这是 run 结束后的附属产物——不建会话、不走 SSE、
6
+ * 不接配额与计费、不写 runLog。调用方(server.ts 路由)负责按人格复核生效模式,
7
+ * 并在**任何失败**时回落 `branding.ui.followUp.static`,绝不 4xx/5xx 冒泡。
8
+ *
9
+ * 与 `@assistant-ui/react` 的接法:前端实现自定义 `SuggestionAdapter.generate`
10
+ * 直接发结构化 messages(库自带的 `createSuggestionAdapter` 会把消息拍成单个
11
+ * prompt 字符串,服务端无法按 role 分离、无法强制中文指令,裁剪也不可测)。
12
+ */
13
+ import type { ModelRuntime } from "@earendil-works/pi-coding-agent";
14
+ import { type LoadedProduct } from "./manifest.ts";
15
+ /** 裁剪后的单条对话消息:只有文本,图片/附件/工具细节从不离开前端。 */
16
+ export interface ClippedMessage {
17
+ role: "user" | "assistant";
18
+ text: string;
19
+ }
20
+ /** 生成层的输入。`personaId` 由路由用于复核生效模式,生成层本身不用它。 */
21
+ export interface SuggestionsInput {
22
+ messages: ClippedMessage[];
23
+ count: number;
24
+ /** 生成失败时的回落内容(`branding.ui.followUp.static`)。 */
25
+ staticFallback: string[];
26
+ /** 覆盖内置生成指令(`branding.ui.followUp.systemPrompt`)。 */
27
+ systemPrompt?: string;
28
+ timeoutMs: number;
29
+ }
30
+ /** 生成层的依赖。真实现读 `deps.modelRuntime`;测试注入替身避免真花钱。 */
31
+ export interface SuggestionsEnv {
32
+ product: LoadedProduct;
33
+ modelRuntime: ModelRuntime;
34
+ }
35
+ export type SuggestionsRunner = (env: SuggestionsEnv, input: SuggestionsInput) => Promise<string[]>;
36
+ /**
37
+ * 缺省值与硬上限。前端 `followUpConfigOf` 各持一份同名缺省(两个包不共享模块,
38
+ * 单测钉住两边一致)——改这里要同步那边。
39
+ */
40
+ export declare const SUGGESTIONS_DEFAULTS: {
41
+ readonly count: 3;
42
+ readonly maxMessages: 10;
43
+ readonly timeoutMs: 8000;
44
+ readonly maxTokens: 200;
45
+ /** 单条消息文本上限(超出截断)。 */
46
+ readonly messageChars: 500;
47
+ /** 整段对话字符上限(从最新往回收)。 */
48
+ readonly totalChars: 4000;
49
+ /** 单条建议字符上限。 */
50
+ readonly suggestionChars: 80;
51
+ };
52
+ /** 模型回复 → 建议列表:按行拆、去编号前缀、去空行、截到 count 条。 */
53
+ export declare function parseSuggestions(text: string, count: number): string[];
54
+ /**
55
+ * 服务端强制的输入裁剪——前端已裁一道,这里是权威层:
56
+ * 只留 user/assistant 的非空文本、单条截断、取最近 maxMessages 条、整段不超 totalChars。
57
+ */
58
+ export declare function clipMessages(raw: unknown, maxMessages: number): ClippedMessage[];
59
+ /** 真调模型。任何失败都抛给路由(统一 catch 后回落 static)。 */
60
+ export declare function runSuggestions(env: SuggestionsEnv, input: SuggestionsInput): Promise<string[]>;