@deepseek-ai/dsh-goal 0.1.3-alpha.2 → 0.1.5-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/goal/goal/README.md
-README.md: 119c5e246494c7cb14c84b18e03ca04155f2158c
-README.zh.md: f17d9fa6b84fff50c3c7263c92725959bde99775
+README.md: 7810fbb5f78aab73b2959538f1dc8fe64b2b5d62
+README.zh.md: 0852254f4bb6a7e239f3dd8b0134e0170567e1a7

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-goal` keeps one durable completion objective per agent session: the goal's text, phase, round count, and revision history live in the session log, so they survive session resume, fork, and process restarts. You can create, edit, pause, resume, complete, block, and clear a goal, and every mutation is compare-and-set, so a stale view cannot clobber newer state. A goal carries a round cap (default 256) that bounds automatic continuation, and a blocked goal keeps a stable policy code plus a human explanation. It is state, not a scheduler: the service decides nothing about when work continues, and continuation permission is process-local and never persisted. Choose it when one long-running objective should span many turns; skip it for routine single-turn work.
+`dsh-goal` lets one long-running completion objective persist across turns, session resume, fork, and process restarts. Users and agents can create, edit, pause, resume, complete, block, or clear it; compare-and-set updates reject stale views. A configurable round cap (256 by default) bounds automatic continuation, and blocked goals retain a stable policy code with a human-readable explanation. The package stores goal state but does not schedule work, and continuation permission remains process-local rather than durable. Choose it for one objective spanning many turns; skip it for routine single-turn work or parallel objectives.
 
 ## Table of Contents
 
@@ -106,14 +106,14 @@ This section explains how the service realizes the behavior above; the observabl
 |---|---|
 | [`src/index.ts`](src/index.ts) | Plugin entry: `GoalService`, config schema, mutations, activation cache, projection unit |
 | [`src/domain.ts`](src/domain.ts) | Durable change payloads, `goal/changed` event, goal message-source attribution |
-| [`src/types.ts`](src/types.ts) | Pure client-safe types: `GoalView`, `GoalSnapshot`, projection-key declaration |
+| [`src/types.ts`](src/types.ts) | Pure client-safe types: `GoalView`, `GoalSnapshot`, `GoalActivationChanged`, projection-key declaration |
 | [`src/fold.ts`](src/fold.ts) | Strict replay fold and decoder for durable goal changes |
 | [`src/runtime.ts`](src/runtime.ts) | `GoalId` brand, `GoalError` codes, change-version constant |
 | [`src/invariant.ts`](src/invariant.ts) | Invariant companion: independent incremental fold over every attached session |
 
 ### Events and attribution
 
-`goal/changed` fires after the durable event commits, with listener failures contained; the payload carries the operation, the exact ref, and the fresh view (absent for a clear tombstone). Admitted continuation rounds are attributed through `GoalMessageSource { goalId, revision, round }` on the `user/message` event, which the strict fold validates as the next admitted round of the current goal.
+`goal/changed` fires after the durable event commits, with listener failures contained; the payload carries the operation, the exact ref, and the fresh view (absent for a clear tombstone). `goal/activation-changed` forwards a process-local `armed`/`disarmed` edge with the exact current ref, or no goal after a clear, without changing durable state. Admitted continuation rounds are attributed through `GoalMessageSource { goalId, revision, round }` on the `user/message` event, which the strict fold validates as the next admitted round of the current goal.
 
 </details>
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-`dsh-goal` 为每个 agent 会话保留一个持久的完成目标：目标的文本、phase、Round 数量与 revision 历史都保存在会话日志中，因此会话 resume（恢复）、fork 与进程重启后依然存在。你可以 create、edit、pause、resume、complete、block 和 clear 一个 goal，且每次变更都是比较并设置，陈旧的视图不会覆盖更新的状态。goal 带有 Round 上限（默认 256）以约束自动续行，被阻塞的 goal 会保留稳定的策略代码和面向人的说明。它是状态而非调度器：服务不决定工作何时继续，续行权限是进程本地的且绝不持久化。当单个长期目标需要横跨多轮时选择它；常规单轮工作不要使用。
+`dsh-goal` 让一个长期完成目标在多轮、会话 resume（恢复）、fork 与进程重启后持续存在。用户与 agent 可以 create、edit、pause、resume、complete、block 或 clear 该目标；比较并设置的更新会拒绝陈旧视图。可配置的 Round 上限（默认 256）约束自动续行，被阻塞的 goal 会保留稳定的策略代码和面向人的说明。本包存储 goal 状态但不调度工作，续行权限是进程本地的而非持久状态。单个目标需要横跨多轮时选择本包；常规单轮工作或并行目标不要使用。
 
 ## 目录
 
@@ -106,14 +106,14 @@ view.activation                        // 'armed' | 'disarmed' — not persisted
 |---|---|
 | [`src/index.ts`](src/index.ts) | 插件入口：`GoalService`、config schema、变更、续行启用缓存、投影单元 |
 | [`src/domain.ts`](src/domain.ts) | 持久变更载荷、`goal/changed` 事件、goal 消息来源归属 |
-| [`src/types.ts`](src/types.ts) | 纯客户端安全类型：`GoalView`、`GoalSnapshot`、投影键声明 |
+| [`src/types.ts`](src/types.ts) | 纯客户端安全类型：`GoalView`、`GoalSnapshot`、`GoalActivationChanged`、投影键声明 |
 | [`src/fold.ts`](src/fold.ts) | 持久 goal 变更的严格回放折叠与解码器 |
 | [`src/runtime.ts`](src/runtime.ts) | `GoalId` 品牌、`GoalError` 代码、变更版本常量 |
 | [`src/invariant.ts`](src/invariant.ts) | 不变式伴生：对每个已挂接会话的独立增量折叠 |
 
 ### 事件与归属
 
-`goal/changed` 在持久事件提交后触发，监听器失败会被隔离；载荷携带操作、精确 ref 与最新视图（clear tombstone 时省略）。已准入的续行 Round 通过 `user/message` 事件上的 `GoalMessageSource { goalId, revision, round }` 归属，严格折叠会将其验证为当前 goal 的下一个已准入 Round。
+`goal/changed` 在持久事件提交后触发，监听器失败会被隔离；载荷携带操作、精确 ref 与最新视图（clear tombstone 时省略）。`goal/activation-changed` 在不改变持久状态的情况下，转发携带精确当前 ref 的进程本地 `armed`／`disarmed` 边界；clear 后则不携带 goal。已准入的续行 Round 通过 `user/message` 事件上的 `GoalMessageSource { goalId, revision, round }` 归属，严格折叠会将其验证为当前 goal 的下一个已准入 Round。
 
 </details>
 

package/lib/index.js

@@ -483,6 +483,7 @@ function resolveBlockReason(reason) {
 let GoalService = (() => {
 	let _classSuper = TypertRemoteService;
 	let _instanceExtraInitializers = [];
+	let _get_decorators;
 	let _edit_decorators;
 	let _pause_decorators;
 	let _resume_decorators;
@@ -492,12 +493,24 @@ let GoalService = (() => {
 	return class GoalService extends _classSuper {
 		static {
 			const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+			_get_decorators = [Remote("get")];
 			_edit_decorators = [Remote("edit")];
 			_pause_decorators = [Remote("pause")];
 			_resume_decorators = [Remote("resume")];
 			_complete_decorators = [Remote("complete")];
 			_clear_decorators = [Remote("clear")];
 			_remoteExportCreate_decorators = [Remote("create")];
+			__esDecorate(this, null, _get_decorators, {
+				kind: "method",
+				name: "get",
+				static: false,
+				private: false,
+				access: {
+					has: (obj) => "get" in obj,
+					get: (obj) => obj.get
+				},
+				metadata: _metadata
+			}, null, _instanceExtraInitializers);
 			__esDecorate(this, null, _edit_decorators, {
 				kind: "method",
 				name: "edit",
@@ -579,13 +592,14 @@ let GoalService = (() => {
 			super(ctx, "goals");
 			this.resolved = { defaultMaxGoalRounds: resolveMaxGoalRounds(config.defaultMaxGoalRounds ?? 256) };
 			ctx.on("agent/session-start", ({ agent }) => {
-				this.runtimeState(agent.session).activation = "disarmed";
+				this.setActivation(agent.session, "disarmed");
 			});
 			ctx.sessionProjections.register(goalProjectionDefinition);
 			ctx.on("session/event", (session, event) => {
 				if (event.type !== "goal/change") return;
 				const runtime = this.runtimeState(session);
-				runtime.activation = runtime.pendingActivation !== void 0 && SessionSeq(runtime.pendingActivation.offset) === event.seq ? runtime.pendingActivation.activation : "disarmed";
+				const activation = runtime.pendingActivation !== void 0 && SessionSeq(runtime.pendingActivation.offset) === event.seq ? runtime.pendingActivation.activation : "disarmed";
+				this.setActivation(session, activation);
 			});
 		}
 		/**
@@ -607,8 +621,8 @@ let GoalService = (() => {
 		*/
 		disarm(agent) {
 			this.assertLive(agent);
+			this.setActivation(agent.session, "disarmed");
 			const runtime = this.runtimeState(agent.session);
-			runtime.activation = "disarmed";
 			return this.view(this.state(agent.session), runtime);
 		}
 		/**
@@ -771,6 +785,25 @@ let GoalService = (() => {
 			this.runtimeStates.set(session, runtime);
 			return runtime;
 		}
+		/** Publish one process-local activation edge when it actually changes. */
+		setActivation(session, activation) {
+			const runtime = this.runtimeState(session);
+			if (runtime.activation === activation) return;
+			runtime.activation = activation;
+			const state = this.ctx.sessionProjections.stateOf(session, "goal");
+			/* v8 ignore next -- static inject requires the projection registry before this service activates. */
+			if (state === void 0) return;
+			if (state.failure !== null) return;
+			const goal = this.view(state.current, runtime);
+			this.ctx.emit("goal/activation-changed", {
+				sessionId: session.id,
+				...goal === void 0 ? {} : { goal: {
+					id: goal.id,
+					revision: goal.revision,
+					activation: goal.activation
+				} }
+			});
+		}
 		/** Build a new revision with one replacement phase. */
 		withPhase(current, phase) {
 			return {

package/lib/typert.host.js

@@ -65,6 +65,22 @@ const _deepseek_ai_dsh_goal_goals_edit_result$schema = z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'revision': z.number().readonly(),
 })
+const _deepseek_ai_dsh_goal_goals_get_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _deepseek_ai_dsh_goal_goals_get_result$schema = z.union([z.undefined(), z.object({
+  'roundsStarted': z.number().readonly(),
+  'createdAt': z.number().readonly(),
+  'updatedAt': z.number().readonly(),
+  'activation': z.union([z.literal("armed"), z.literal("disarmed")]).readonly(),
+  'objective': z.string().readonly(),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'blockedReason': z.object({
+  'code': z.string().readonly(),
+  'message': z.string().readonly(),
+}).readonly().optional(),
+  'maxGoalRounds': z.number().readonly(),
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'revision': z.number().readonly(),
+})])
 const _deepseek_ai_dsh_goal_goals_pause_parameter_0$schema = z.intersection(z.string(), z.unknown())
 const _deepseek_ai_dsh_goal_goals_pause_parameter_1$schema = z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
@@ -150,7 +166,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalRef',
         schema: _deepseek_ai_dsh_goal_goals_clear_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":431,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":433,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/complete',
@@ -190,7 +206,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_complete_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":389,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":391,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/create',
@@ -231,7 +247,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#CreateGoalResult',
         schema: _deepseek_ai_dsh_goal_goals_create_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":623,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":647,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/edit',
@@ -281,7 +297,37 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_edit_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":327,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":329,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-goal#goals/get',
+      service: 'goals',
+      namespace: 'goals',
+      method: 'get',
+      invocation: { kind: 'direct' },
+      scope: {
+        context: 'agent',
+        wire: 'agentId',
+      },
+      parameters: [
+        {
+          name: 'agent',
+          wire: 'agentId',
+          source: 'lookup',
+          lookup: 'agent',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            schema: _deepseek_ai_dsh_goal_goals_get_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-goal#goals/get:result',
+        schema: _deepseek_ai_dsh_goal_goals_get_result$schema,
+      },
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":277,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/pause',
@@ -321,7 +367,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_pause_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":350,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":352,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/resume',
@@ -361,7 +407,7 @@ export const TYPERT = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_resume_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":362,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":364,"column":3},
     },
   ],
   model: {
@@ -377,7 +423,7 @@ export const TYPERT = {
           {
             "kind": "method",
             "name": "get",
-            "signature": "get(agent: Agent): GoalView | undefined",
+            "signature": "@Remote('get') get(agent: Agent): GoalView | undefined",
             "summary": "Read the current goal for one exact live agent.",
             "jsDoc": "/**\n * Read the current goal for one exact live agent.\n * @param agent - owning live agent.\n * @returns a fresh view or `undefined` when no goal is current.\n * @throws {@link GoalError} when the agent is not the registry's live instance.\n */"
           },
@@ -560,7 +606,7 @@ export const TYPERT = {
           },
           {
             "name": "EpochHeader",
-            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
+            "declaration": "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n}"
           },
           {
             "name": "FileAttachmentRef",
@@ -640,7 +686,7 @@ export const TYPERT = {
           },
           {
             "name": "Inbox",
-            "declaration": "export class Inbox {\n    get nextTurn(): readonly UserMessage[];\n    get nextStep(): readonly UserMessage[];\n    get hasPending(): boolean;\n    clear(): void;\n    claim(target: InboxTarget, turn: number): UserMessage[];\n    append(target: InboxTarget, message: UserMessage): void;\n    prepend(target: InboxTarget, message: UserMessage): void;\n    replace(messageId: MessageId, newMessage: UserMessage): boolean;\n    remove(messageId: MessageId): boolean;\n    splice(target: InboxTarget, start: number, deleteCount: number, inserted: UserMessage[]): UserMessage[];\n}"
+            "declaration": "export interface Inbox {\n    readonly nextTurn: readonly UserMessage[];\n    readonly nextStep: readonly UserMessage[];\n    clear(): void;\n    append(target: InboxTarget, message: UserMessage): void;\n    prepend(target: InboxTarget, message: UserMessage): void;\n    replace(messageId: MessageId, newMessage: UserMessage): boolean;\n    remove(messageId: MessageId): boolean;\n    splice(target: InboxTarget, start: number, deleteCount: number, inserted: UserMessage[]): UserMessage[];\n}"
           },
           {
             "name": "InboxTarget",
@@ -740,7 +786,7 @@ export const TYPERT = {
           },
           {
             "name": "RequestContext",
-            "declaration": "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n}"
+            "declaration": "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n    systemPromptUpdate?: SystemPromptUpdate;\n}"
           },
           {
             "name": "RequestHeaderReason",
@@ -756,11 +802,11 @@ export const TYPERT = {
           },
           {
             "name": "SessionEvent",
-            "declaration": "export type SessionEvent<T extends SessionEventType = SessionEventType> = { [K in SessionEventType]: { type: K; seq: SessionSeq; time: number; data: SessionEventMap[K]; ignorable?: true; } & (K extends SurfaceEventType ? { sourceEventSeqs?: SessionSeq[]; surfaceOp?: SurfaceOp; } : object) }[T];"
+            "declaration": "export type SessionEvent<T extends SessionEventType = SessionEventType> = { [K in SessionEventType]: { type: K; seq: SessionSeq; time: number; data: SessionEventMap[K]; ignorable?: true; } & (K extends SurfaceEventType ? SurfaceIntent<K> : { surfaceOp?: never; sourceEventSeqs?: never; }) }[T];"
           },
           {
             "name": "SessionEventMap",
-            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/code-dispatch-start': PtcDispatchStartEventData;\n    'tool/code-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
+            "declaration": "export interface SessionEventMap {\n    'turn/start': { turn: number; };\n    'turn/end': { turn: number; reason: TurnEndReason; };\n    'step/start': { turn: number; step: number; };\n    'step/end': { turn: number; step: number; };\n    'user/message': UserMessage;\n    'system/message': { turn: number; step: number; message: SystemMessage; };\n    'assistant/message': { turn: number; step: number; message: AssistantMessage; stream: AssistantStreamRecord[]; usage?: TokenUsage; interrupted?: true; };\n    'assistant/attempt': { turn: number; step: number; stream: AssistantStreamRecord[]; };\n    'tool/call': { turn: number; step: number; callId: ToolCallId; name: string; arguments: string; };\n    'tool/result': { turn: number; step: number; message: ToolResultMessage; error?: { name: string; code: string; }; meta?: JsonValue; };\n    'request/header': { header: EpochHeader; reason: RequestHeaderReason; startsSeries?: true; };\n    'request/context': RequestContext;\n    'session/end-seed': { inherited?: true; };\n    'agent/inbox/spliced': { target: InboxTarget; start: number; removedCount?: number; inserted: UserMessage[]; outcome?: 'canceled'; };\n    'approval/asked': { id: ApprovalRequestId; toolName: string; callId?: ToolCallId; reason?: string; };\n    'approval/decided': { id: ApprovalRequestId; outcome: ApprovalOutcome; };\n    'approval/policy': { policy: ApprovalPolicy; source?: 'delegation'; };\n    'tool/ptc-dispatch-start': PtcDispatchStartEventData;\n    'tool/ptc-dispatch': PtcDispatchEventData;\n    'agent-preset/selected': { agentPreset: string; };\n    'command/run': { commandId: CommandId; name: string; args?: string; source: CommandSource; };\n    'command/done': { commandId: CommandId; kind: 'success' | 'error'; text?: string; sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq; };\n    'session/title': SessionTitleEventData;\n    'todo/write': { todos: TodoItem[]; };\n    'model/selection': ModelSelection;\n    'subagent/descriptor': SubagentDescriptorData;\n    'sandbox/mode': { mode: SandboxMode; source?: 'delegation'; };\n    'team/member': { version: 2; teamId: TeamId; member: TeamMemberSnapshot; };\n    'team/task': { version: 2; teamId: TeamId; task: TeamTaskSnapshot; };\n    'team/message/queued': { version: 2; teamId: TeamId; message: TeamMessageSnapshot; };\n    'team/message/delivered': { version: 2; teamId: TeamId; messageId: TeamMessageId; targetId: SessionId; };\n    'goal/change': GoalChangeMeta;\n    'feedback/message-put': MessageFeedbackPut;\n    'feedback/message-delete': MessageFeedbackDelete;\n    'compaction/start': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; };\n    'compaction/summary': { compactionId: CompactionId; sourceCommandId?: CommandId; summary: ContentBlock[]; shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; provider: string; model: string; maxTokens?: number; usage?: TokenUsage; } & ({ rawOutput: ContentBlock[]; llmStreamCall: true; } | { rawOutput?: ContentBlock[]; llmStreamCall?: never; });\n    'compaction/end': { compactionId: CompactionId; sourceCommandId?: CommandId; turn: number | null; error?: string; };\n    'compaction/prune': { shadowedRange: { start: SessionSeq; end: SessionSeq; }; shadowedSeqs: SessionSeq[]; shadowedTokenCount: number; };\n}"
           },
           {
             "name": "SessionEventType",
@@ -832,7 +878,7 @@ export const TYPERT = {
           },
           {
             "name": "SurfaceEventType",
-            "declaration": "export type SurfaceEventType = 'user/message' | 'assistant/message' | 'tool/result';"
+            "declaration": "export type SurfaceEventType = 'system/message' | 'user/message' | 'assistant/message' | 'tool/result';"
           },
           {
             "name": "SurfaceIntent",
@@ -840,7 +886,15 @@ export const TYPERT = {
           },
           {
             "name": "SurfaceOp",
-            "declaration": "export type SurfaceOp = 'append' | { op: 'replace'; start: SessionSeq; end: SessionSeq; };"
+            "declaration": "export type SurfaceOp = 'append' | { op: 'replace'; startSeq: SessionSeq; endSeq: SessionSeq; };"
+          },
+          {
+            "name": "SystemMessage",
+            "declaration": "export interface SystemMessage extends Message {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['plugin'];\n}"
+          },
+          {
+            "name": "SystemPromptUpdate",
+            "declaration": "export type SystemPromptUpdate = 'in-history';"
           },
           {
             "name": "TeamId",
@@ -938,6 +992,27 @@ export const TYPERT = {
       }
     ],
     "events": [
+      {
+        "description": "Process-local goal activation changed for one session.",
+        "summary": "Process-local goal activation changed for one session.",
+        "tags": [
+          {
+            "name": "mode",
+            "comment": "emit",
+            "text": "@mode emit\n     *"
+          },
+          {
+            "name": "param",
+            "argument": "payload",
+            "comment": "- session id and the exact current goal activation, or no goal after a clear.",
+            "text": "@param payload - session id and the exact current goal activation, or no goal after a clear."
+          }
+        ],
+        "jsDoc": "/**\n * Process-local goal activation changed for one session.\n * @mode emit\n * @param payload - session id and the exact current goal activation, or no goal after a clear.\n */",
+        "name": "goal/activation-changed",
+        "mode": "emit",
+        "signature": "'goal/activation-changed'(payload: GoalActivationChanged): void"
+      },
       {
         "description": "Goal mutation accepted by one live agent. The matching `goal/change` session event has already committed. Listener failures are contained. Scope-filtered dispatch (`@deepseek-ai/dsh-scope`): agent-scoped listeners receive only that agent.",
         "summary": "Goal mutation accepted by one live agent.",

package/lib/typert.remote-client.d.ts

@@ -12,6 +12,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
     complete: (agentId: SessionId, ref: GoalRef) => Promise<RemoteResult<GoalView>>
     create: (agentId: SessionId, request: CreateGoalRequest) => Promise<RemoteResult<CreateGoalResult>>
     edit: (agentId: SessionId, ref: GoalRef, request: EditGoalRequest) => Promise<RemoteResult<GoalView>>
+    get: (agentId: SessionId) => Promise<RemoteResult<GoalView | undefined>>
     pause: (agentId: SessionId, ref: GoalRef) => Promise<RemoteResult<GoalView>>
     resume: (agentId: SessionId, ref: GoalRef) => Promise<RemoteResult<GoalView>>
   }
@@ -20,6 +21,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
     'goals/complete': (agentId: SessionId, ref: GoalRef) => Promise<RemoteResult<GoalView>>
     'goals/create': (agentId: SessionId, request: CreateGoalRequest) => Promise<RemoteResult<CreateGoalResult>>
     'goals/edit': (agentId: SessionId, ref: GoalRef, request: EditGoalRequest) => Promise<RemoteResult<GoalView>>
+    'goals/get': (agentId: SessionId) => Promise<RemoteResult<GoalView | undefined>>
     'goals/pause': (agentId: SessionId, ref: GoalRef) => Promise<RemoteResult<GoalView>>
     'goals/resume': (agentId: SessionId, ref: GoalRef) => Promise<RemoteResult<GoalView>>
   }
@@ -31,6 +33,7 @@ declare module '@deepseek-ai/dsh-typert-protocol' {
     'agent:goals/complete': (ref: GoalRef) => Promise<RemoteResult<GoalView>>
     'agent:goals/create': (request: CreateGoalRequest) => Promise<RemoteResult<CreateGoalResult>>
     'agent:goals/edit': (ref: GoalRef, request: EditGoalRequest) => Promise<RemoteResult<GoalView>>
+    'agent:goals/get': () => Promise<RemoteResult<GoalView | undefined>>
     'agent:goals/pause': (ref: GoalRef) => Promise<RemoteResult<GoalView>>
     'agent:goals/resume': (ref: GoalRef) => Promise<RemoteResult<GoalView>>
   }

package/lib/typert.remote-client.js

@@ -65,6 +65,22 @@ const _deepseek_ai_dsh_goal_goals_edit_result$schema = z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
   'revision': z.number().readonly(),
 })
+const _deepseek_ai_dsh_goal_goals_get_parameter_0$schema = z.intersection(z.string(), z.unknown())
+const _deepseek_ai_dsh_goal_goals_get_result$schema = z.union([z.undefined(), z.object({
+  'roundsStarted': z.number().readonly(),
+  'createdAt': z.number().readonly(),
+  'updatedAt': z.number().readonly(),
+  'activation': z.union([z.literal("armed"), z.literal("disarmed")]).readonly(),
+  'objective': z.string().readonly(),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'blockedReason': z.object({
+  'code': z.string().readonly(),
+  'message': z.string().readonly(),
+}).readonly().optional(),
+  'maxGoalRounds': z.number().readonly(),
+  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'revision': z.number().readonly(),
+})])
 const _deepseek_ai_dsh_goal_goals_pause_parameter_0$schema = z.intersection(z.string(), z.unknown())
 const _deepseek_ai_dsh_goal_goals_pause_parameter_1$schema = z.object({
   'id': z.intersection(z.string(), z.unknown()).readonly(),
@@ -147,7 +163,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalRef',
         schema: _deepseek_ai_dsh_goal_goals_clear_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":431,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":433,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/complete',
@@ -187,7 +203,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_complete_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":389,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":391,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/create',
@@ -228,7 +244,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#CreateGoalResult',
         schema: _deepseek_ai_dsh_goal_goals_create_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":623,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":647,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/edit',
@@ -278,7 +294,37 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_edit_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":327,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":329,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-goal#goals/get',
+      service: 'goals',
+      namespace: 'goals',
+      method: 'get',
+      invocation: { kind: 'direct' },
+      scope: {
+        context: 'agent',
+        wire: 'agentId',
+      },
+      parameters: [
+        {
+          name: 'agent',
+          wire: 'agentId',
+          source: 'lookup',
+          lookup: 'agent',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            schema: _deepseek_ai_dsh_goal_goals_get_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-goal#goals/get:result',
+        schema: _deepseek_ai_dsh_goal_goals_get_result$schema,
+      },
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":277,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/pause',
@@ -318,7 +364,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_pause_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":350,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":352,"column":3},
     },
     {
       id: '@deepseek-ai/dsh-goal#goals/resume',
@@ -358,7 +404,7 @@ export const TYPERT_REMOTE = {
         typeSymbol: '@deepseek-ai/dsh-goal/client#GoalView',
         schema: _deepseek_ai_dsh_goal_goals_resume_result$schema,
       },
-      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":362,"column":3},
+      sourceLocation: {"file":"packages/goal/goal/src/index.ts","line":364,"column":3},
     },
   ],
 }

package/lib/types/index.d.ts

@@ -136,6 +136,8 @@ export declare class GoalService extends TypertRemoteService {
     private state;
     /** Return the process-local activation state, initially disarmed. */
     private runtimeState;
+    /** Publish one process-local activation edge when it actually changes. */
+    private setActivation;
     /** Build a new revision with one replacement phase. */
     private withPhase;
     /** Shared validated phase transition. */

package/lib/types/index.js

@@ -186,6 +186,7 @@ function resolveBlockReason(reason) {
 let GoalService = (() => {
     let _classSuper = TypertRemoteService;
     let _instanceExtraInitializers = [];
+    let _get_decorators;
     let _edit_decorators;
     let _pause_decorators;
     let _resume_decorators;
@@ -195,12 +196,14 @@ let GoalService = (() => {
     return class GoalService extends _classSuper {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _get_decorators = [Remote('get')];
             _edit_decorators = [Remote('edit')];
             _pause_decorators = [Remote('pause')];
             _resume_decorators = [Remote('resume')];
             _complete_decorators = [Remote('complete')];
             _clear_decorators = [Remote('clear')];
             _remoteExportCreate_decorators = [Remote('create')];
+            __esDecorate(this, null, _get_decorators, { kind: "method", name: "get", static: false, private: false, access: { has: obj => "get" in obj, get: obj => obj.get }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _edit_decorators, { kind: "method", name: "edit", static: false, private: false, access: { has: obj => "edit" in obj, get: obj => obj.edit }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _pause_decorators, { kind: "method", name: "pause", static: false, private: false, access: { has: obj => "pause" in obj, get: obj => obj.pause }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _resume_decorators, { kind: "method", name: "resume", static: false, private: false, access: { has: obj => "resume" in obj, get: obj => obj.resume }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -221,17 +224,18 @@ let GoalService = (() => {
                 defaultMaxGoalRounds: resolveMaxGoalRounds(config.defaultMaxGoalRounds ?? 256),
             };
             ctx.on('agent/session-start', ({ agent }) => {
-                this.runtimeState(agent.session).activation = 'disarmed';
+                this.setActivation(agent.session, 'disarmed');
             });
             ctx.sessionProjections.register(goalProjectionDefinition);
             ctx.on('session/event', (session, event) => {
                 if (event.type !== 'goal/change')
                     return;
                 const runtime = this.runtimeState(session);
-                runtime.activation = runtime.pendingActivation !== undefined
+                const activation = runtime.pendingActivation !== undefined
                     && SessionSeq(runtime.pendingActivation.offset) === event.seq
                     ? runtime.pendingActivation.activation
                     : 'disarmed';
+                this.setActivation(session, activation);
             });
         }
         /**
@@ -253,8 +257,8 @@ let GoalService = (() => {
          */
         disarm(agent) {
             this.assertLive(agent);
+            this.setActivation(agent.session, 'disarmed');
             const runtime = this.runtimeState(agent.session);
-            runtime.activation = 'disarmed';
             return this.view(this.state(agent.session), runtime);
         }
         /**
@@ -423,6 +427,30 @@ let GoalService = (() => {
             this.runtimeStates.set(session, runtime);
             return runtime;
         }
+        /** Publish one process-local activation edge when it actually changes. */
+        setActivation(session, activation) {
+            const runtime = this.runtimeState(session);
+            if (runtime.activation === activation)
+                return;
+            runtime.activation = activation;
+            const state = this.ctx.sessionProjections.stateOf(session, 'goal');
+            /* v8 ignore next -- static inject requires the projection registry before this service activates. */
+            if (state === undefined)
+                return;
+            if (state.failure !== null)
+                return;
+            const goal = this.view(state.current, runtime);
+            this.ctx.emit('goal/activation-changed', {
+                sessionId: session.id,
+                ...goal === undefined ? {} : {
+                    goal: {
+                        id: goal.id,
+                        revision: goal.revision,
+                        activation: goal.activation,
+                    },
+                },
+            });
+        }
         /** Build a new revision with one replacement phase. */
         withPhase(current, phase) {
             return {

package/lib/types/types.d.ts

@@ -10,6 +10,7 @@
  * @module @deepseek-ai/dsh-goal/types
  */
 import type { Branded } from '@deepseek-ai/dsh-brand';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
 /** Identifies one goal across its durable revisions. */
 export type GoalId = Branded<'GoalId'>;
 /** Compare-and-set identity for one exact goal revision. */
@@ -55,6 +56,20 @@ export interface GoalSnapshot extends GoalRef {
 }
 /** Whether this live process may automatically continue an active goal. */
 export type GoalActivation = 'armed' | 'disarmed';
+/** Live process-local activation update forwarded to UI clients. */
+export interface GoalActivationChanged {
+    /** Session whose live goal activation changed. */
+    readonly sessionId: SessionId;
+    /** Current exact activation, absent when no goal is current. */
+    readonly goal?: {
+        /** Exact current goal identity. */
+        readonly id: GoalId;
+        /** Exact current goal revision. */
+        readonly revision: number;
+        /** Current process-local continuation state. */
+        readonly activation: GoalActivation;
+    };
+}
 /** Current goal projection, including values derived from the session log. */
 export interface GoalView extends GoalSnapshot {
     /** Highest admitted round number for this goal. */
@@ -105,4 +120,14 @@ declare module '@deepseek-ai/dsh-session-projection/types' {
         goal: GoalProjection | null;
     }
 }
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * Process-local goal activation changed for one session.
+         * @mode emit
+         * @param payload - session id and the exact current goal activation, or no goal after a clear.
+         */
+        'goal/activation-changed'(payload: GoalActivationChanged): void;
+    }
+}
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-goal",
   "description": "Event-sourced same-session goal state and lifecycle service for the DeepSeek Harness",
-  "version": "0.1.3-alpha.2",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -53,34 +53,36 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-session-projection": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-brand": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-agent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.3-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.5-alpha.1"
   },
   "dependencies": {
     "zod": "^4.4.3",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-bash-local": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-brand": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-loader-smoke": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session-checkpoint-policy": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-subprocess-local": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.3-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-bash-local": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-loader-smoke": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-checkpoint-policy": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-subprocess-local": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.1"
   }
 }