@gencode/shared 0.0.20 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @gencode/shared
+
+## 0.1.1
+
+### Patch Changes
+
+- Bump patch version for npm publishing.
+
+## 0.1.0
+
+### Minor Changes
+
+- 71b3e30: Add stable session metadata types to @gencode/shared, expand memory tool suite, and switch subagent spawn to synchronous result delivery.
+
+  - @gencode/shared: export `SessionSummary` and `SessionMetadata` types for cross-package use
+  - @gencode/agents: add memory_write, memory_log, memory_list, memory_forget, memory_update tools; improve memory tool descriptions and system prompt guidance; change subagent spawn from async acceptance to synchronous result return; suppress redundant assistant text after subagent completion
+  - @gencode/cli: update memory tool test coverage to match new tools
+
+### Patch Changes
+
+- 350b9d1: Add a publish-time changelog guard and include package changelogs in npm artifacts.
+
+## 0.0.20
+
+### Patch Changes
+
+- Establish the initial changelog baseline for the current published package version.

package/README.md

@@ -0,0 +1,84 @@
+# @gencode/shared
+
+## 包定位
+
+`@gencode/shared` 负责跨包共享的稳定类型与协议定义。
+它存在的目的，是防止 `agents`、`cli`、`web` 等包之间出现协议漂移和镜像定义。
+
+## 负责内容
+
+这个包适合承载：
+- 稳定共享类型
+- 被多个包复用的 request / response 协议结构
+- callback payload 结构
+- websocket 事件载荷结构
+- 共享的 run-event / progress-event 定义
+- HITL、UI-tool 等跨包共享契约
+
+## 不负责内容
+
+这个包不应包含：
+- 包特定的运行时编排逻辑
+- transport 副作用
+- Web 服务行为
+- CLI 命令逻辑
+- agent 领域逻辑
+
+## 当前源码入口
+
+阅读本包时，建议先看：
+- `src/index.ts` —— 对外导出入口
+- `src/agent-progress.ts`
+- `src/context-protocol.ts`
+- `src/hitl.ts`
+- `src/run-events.ts`
+- `src/ui-tool.ts`
+
+当前测试包括：
+- `src/agent-progress.test.ts`
+- `src/context-protocol.test.ts`
+- `src/hitl.test.ts`
+- `src/run-events.test.ts`
+- `src/ui-tool.test.ts`
+
+当 `dist/` 存在时，应将其视为构建输出，而不是源码事实来源。
+
+## 与其他包的关系
+
+- 当 `@gencode/agents` 的内部结果需要对外形成稳定共享结构时，应优先使用本包
+- `@gencode/cli` 应尽量消费本包中的共享协议，而不是本地重新定义
+- `@gencode/web` 在消费 CLI 输出时，也应尽量与本包中的契约保持一致
+
+## 开发说明
+
+一个类型或协议通常应该放在这里，当它满足以下条件之一：
+- 被多个包共同依赖
+- 描述了稳定的跨包契约
+- 若出现镜像定义，漂移风险较高
+
+一个类型通常不应放在这里，当它：
+- 只在单个包内使用
+- 仅服务于某个内部实现细节
+- 附带运行时行为，而不是共享结构
+
+## 验证
+
+在工作区根目录可运行：
+
+```bash
+pnpm -C source/packages/shared test
+```
+
+工作区级验证：
+
+```bash
+pnpm -C source typecheck
+pnpm -C source test
+```
+
+## 相关规格文档
+
+- `../../../specs/system-overview.md`
+- `../../../specs/architecture-boundaries.md`
+- `../../../specs/repo-map.md`
+- `../../../specs/implementation-backlog.md`

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export { isAgentDiagnosticEvent } from "./agent-progress.js";
 export { formatTaskForDisplay } from "./task-display.js";
 export type { AgentCustomProgressEvent, AgentDiagnosticEvent, AgentDiagnosticLevel, AgentDiagnosticScope, AgentProgressEvent, AgentProgressEventBase, } from "./agent-progress.js";
 export type { CallbackEventPayload, Channel, RunResultPayload, StreamEnvelope, StreamEventName, } from "./run-events.js";
+export type { SessionMetadata, SessionSummary } from "./session.js";
 export type { CollapseSpan, CompressionLayer, ContextCompactionState, ModelUsageCheckpoint, ReadStateRecord, SessionMemorySnapshot, SessionContextSnapshot, SnipRecord, ToolResultReference, ToolResultBudgetRecord, } from "./context-protocol.js";
 export { isHitlPending, isHitlResolved, isHitlExpired, isHitlTool, HITL_TOOL_NAMES, parseMatchedTextToResolution, parseTextToResolution, } from "./hitl.js";
 export type { HitlKind, HitlChoice, HitlChoiceInput, HitlTextInput, HitlFormInput, HitlInputSchema, HitlPreview, HitlPolicy, HitlRequest, HitlResolution, HitlCheckpointPhase, HitlCheckpoint, HitlToolContext, HitlStatus, PausedRunState, HitlHistoryEntry, } from "./hitl.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,OAAO,EACP,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,OAAO,EACP,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,WAAW,EACX,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA6BzD,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAoBnB,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA8BzD,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,EACf,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAoBnB,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,28 @@
+import type { Channel } from "./run-events.js";
+/**
+ * Stable cross-package session summary shape.
+ *
+ * This type is intended for list / query / display scenarios shared across
+ * packages such as agents, cli, and future web integrations.
+ */
+export type SessionSummary = {
+    id: string;
+    title: string;
+    channel: Channel;
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * Stable cross-package session metadata record.
+ *
+ * This type represents the canonical persisted metadata envelope for a session
+ * without including transcript, context snapshot, or export-specific payloads.
+ */
+export type SessionMetadata = {
+    id: string;
+    title: string;
+    channel: Channel;
+    createdAt: string;
+    updatedAt: string;
+};
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gencode/shared",
-  "version": "0.0.20",
+  "version": "0.1.1",
   "type": "module",
   "exports": {
     "./config": {
@@ -13,7 +13,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"