shennian 0.3.39 → 0.3.41

package/node_modules/@shennian/wire/dist/room.d.ts

@@ -1,3 +1,4 @@
+import { type AgentType } from './session.ts';
 export type RoomVisibility = 'private' | 'public_read';
 export type RoomJoinPolicy = 'open' | 'approval' | 'closed';
 export type RoomStatus = 'active' | 'archived' | 'deleted';
@@ -9,11 +10,15 @@ export type RoomActivationMode = 'auto_follow' | 'mention_only' | 'paused';
 export type RoomActivationCapability = 'managed' | 'idle_resume' | 'notify_only';
 export type RoomBindingMode = 'managed' | 'hook_native';
 export type RoomBindingStatus = 'pending_approval' | 'active' | 'paused' | 'detached';
-export type RoomRuntimeAdapter = 'codex' | 'claude_code' | 'workbuddy';
+/** `claude_code` is accepted only as a legacy wire value. New writers use the real AgentType. */
+export type RoomRuntimeAdapter = Exclude<AgentType, 'manager' | 'pi' | 'openclaw'> | 'claude_code';
 export type RoomAttachmentKind = 'image' | 'audio' | 'video' | 'file';
 export type RoomAttachmentStatus = 'pending' | 'uploaded' | 'scanning' | 'ready' | 'rejected' | 'expired' | 'deleted';
 /** JSON-safe representation of the database BIGINT sequence. */
 export type RoomSequence = string;
+export declare function roomRuntimeAgentType(value: string): AgentType | null;
+export declare function isRoomRuntimeAdapter(value: string): value is RoomRuntimeAdapter;
+export declare function roomRuntimeAdapterForAgent(agentType: AgentType): RoomRuntimeAdapter | null;
 export type RoomSummary = {
     id: string;
     name: string;
@@ -28,6 +33,18 @@ export type RoomSummary = {
     membershipRole?: RoomMembershipRole;
     pinnedAt?: string | null;
     updatedAt: string;
+    /** Optional list projection used by local-first clients to avoid per-room requests. */
+    latestMessage?: RoomMessageView | null;
+    /** Compact active-member projection for the list avatar. */
+    avatarMembers?: Array<{
+        id: string;
+        principalType: RoomPrincipalType;
+        displayAlias: string;
+        /** Stable membership ordering key; older servers may omit it. */
+        joinedAt?: string;
+        avatar?: Record<string, unknown> | null;
+        ownerAvatar?: Record<string, unknown> | null;
+    }>;
 };
 export type RoomAuthorSnapshot = {
     membershipId: string;

package/node_modules/@shennian/wire/dist/room.js

@@ -1,3 +1,20 @@
 // @arch docs/features/network-rooms/implementation-plan.md
 // @test src/__tests__/room.test.ts
-export {};
+import { isAvailableAgentType } from "./session.js";
+export function roomRuntimeAgentType(value) {
+    if (value === 'claude_code')
+        return 'claude';
+    if (!isAvailableAgentType(value) ||
+        value === 'manager' ||
+        value === 'pi' ||
+        value === 'openclaw') {
+        return null;
+    }
+    return value;
+}
+export function isRoomRuntimeAdapter(value) {
+    return roomRuntimeAgentType(value) !== null;
+}
+export function roomRuntimeAdapterForAgent(agentType) {
+    return roomRuntimeAgentType(agentType) ? agentType : null;
+}

package/node_modules/@shennian/wire/dist/session.d.ts

@@ -45,6 +45,10 @@ export type AgentRuntimeSummary = {
 export type AgentInfo = {
     type: AgentType;
     models: ModelInfo[];
+    /** True when this provider can back a stable Shennian Agent and managed Room session. */
+    supportsManagedAgent?: boolean;
+    /** True when Manager mode can create this provider as a worker. */
+    supportsWorker?: boolean;
     /** True only after this real provider passed Manager-mode runtime validation. */
     supportsManagerMode?: boolean;
     /** Per-machine Agent provider config summary (additive, non-secret). */
@@ -80,6 +84,12 @@ export type SessionActivitySnapshot = {
     toolCallCount?: number;
     /** True when the daemon owns a live control channel that can stop the active run. */
     canStop?: boolean;
+    /** Optional owner projection for runs controlled by a native desktop host. */
+    owner?: 'shennian' | 'external';
+    /** Human-readable native owner. Older clients safely ignore this field. */
+    ownerLabel?: string;
+    /** External-owner lifecycle. `runPhase` remains the backwards-compatible projection. */
+    lifecycle?: 'queued' | 'running';
 };
 export type ExternalChannelSessionStatus = {
     configured?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shennian",
-  "version": "0.3.39",
+  "version": "0.3.41",
   "description": "Shennian — AI Agent Control Plane CLI",
   "type": "module",
   "bin": {
@@ -40,12 +40,14 @@
     "@sinclair/typebox": "^0.34.49",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
+    "qrcode": "^1.5.4",
     "qrcode-terminal": "^0.12.0",
     "ws": "^8.18.1",
     "@shennian/wire": "0.1.5"
   },
   "devDependencies": {
     "@types/node": "^20",
+    "@types/qrcode": "^1.5.6",
     "@types/qrcode-terminal": "^0.12.2",
     "@types/ws": "^8.18.1",
     "esbuild": "^0.27.4",

package/dist/src/commands/agent.d.ts

@@ -1,7 +0,0 @@
-import type { Command } from 'commander';
-type FetchLike = typeof fetch;
-type AgentCommandOptions = {
-    fetchImpl?: FetchLike;
-};
-export declare function registerAgentCommand(program: Command, options?: AgentCommandOptions): void;
-export {};

package/dist/src/commands/agent.js

@@ -1,3 +0,0 @@
-import{loadConfig as f}from"../config/index.js";import{SERVERS as A}from"../region.js";function k(t,n={}){const e=w(n.fetchImpl??fetch),a=t.command("agent").description("Create and manage stable Shennian Agents");a.command("create").description("Create a stable Agent owned by the paired user").requiredOption("--name <name>","Agent display name").requiredOption("--description <description>","Public Agent responsibility").requiredOption("--runtime <runtime>","Agent runtime, for example codex or claude").requiredOption("--workdir <absolute-path>","Absolute working directory").option("--model <model>","Default model").option("--system-prompt <prompt>","Private system prompt").action(async o=>{await u("agent.create",()=>e("POST","/api/agents",{displayName:o.name,description:o.description,runtimeAdapter:o.runtime,workDir:o.workdir,...o.model!=null?{modelId:o.model}:{},...o.systemPrompt!=null?{systemPrompt:o.systemPrompt}:{}}))}),a.command("get <agent-ref>").description("Get one explicitly referenced stable Agent").action(async o=>{const r=g(o);if(!r)return d("invalid_agent_ref","agent-ref is invalid.",null);await u("agent.get",()=>e("GET",`/api/agents/${encodeURIComponent(r)}`))}),a.command("update <agent-ref>").description("Update fields on one explicitly referenced stable Agent").option("--name <name>","Agent display name").option("--description <description>","Public Agent responsibility").option("--runtime <runtime>","Agent runtime").option("--workdir <absolute-path>","Absolute working directory").option("--model <model>","Default model; use an empty value to clear").option("--system-prompt <prompt>","Private system prompt; use an empty value to clear").action(async(o,r)=>{const s=g(o);if(!s)return d("invalid_agent_ref","agent-ref is invalid.",null);const i={};if(r.name!=null&&(i.displayName=r.name),r.description!=null&&(i.description=r.description),r.runtime!=null&&(i.runtimeAdapter=r.runtime),r.workdir!=null&&(i.workDir=r.workdir),r.model!=null&&(i.modelId=r.model),r.systemPrompt!=null&&(i.systemPrompt=r.systemPrompt),Object.keys(i).length===0)return d("no_changes","Provide at least one field to update.",null);await u("agent.update",()=>e("PATCH",`/api/agents/${encodeURIComponent(s)}`,i))}),l(a,"add"),l(a,"list"),l(a,"remove")}function l(t,n){const e=n==="list"?n:`${n} [name]`;t.command(e,{hidden:!0}).allowUnknownOption(!0).description(`Moved to shennian runtime ${n}`).action(()=>d("command_moved",`Custom runtime management moved to "shennian runtime ${n}".`,{type:"run_command",command:`shennian runtime ${n}`}))}function w(t){return async(n,e,a)=>{const o=f();if(!o.machineToken)throw new m("not_paired","Shennian CLI is not paired.",{type:"run_command",command:"shennian pair --browser"});const r=(o.serverUrl??A.cn.url).replace(/\/+$/,"");let s;try{s=await t(`${r}${e}`,{method:n,headers:{authorization:`Bearer ${o.machineToken}`,...a==null?{}:{"content-type":"application/json"}},...a==null?{}:{body:JSON.stringify(a)},signal:AbortSignal.timeout(15e3)})}catch{throw new m("server_unavailable","Shennian service is unavailable.",null)}const i=await h(s);if(!s.ok){const p=y(i)?i:{};throw new m(typeof p.code=="string"?`agent_${p.code}`:`http_${s.status}`,typeof p.error=="string"?p.error:"Agent request failed.",null)}const c=y(i)&&y(i.agent)?i.agent:null;if(!c||typeof c.id!="string"||typeof c.displayName!="string")throw new m("invalid_server_response","Shennian returned an invalid Agent response.",null);return c}}async function u(t,n){try{const e=await n();process.stdout.write(`${JSON.stringify({ok:!0,command:t,result:{agentRef:e.id,name:e.displayName,description:e.description,runtime:e.runtimeAdapter,workdir:e.workDir,model:e.modelId,systemPromptConfigured:!!e.systemPrompt,avatar:e.avatar??null,status:e.status,createdAt:e.createdAt,updatedAt:e.updatedAt}})}
-`)}catch(e){if(e instanceof m){d(e.code,e.message,e.nextAction);return}d("agent_command_failed","Shennian Agent command failed.",null)}}class m extends Error{code;nextAction;constructor(n,e,a){super(e),this.code=n,this.nextAction=a}}function g(t){const n=t.startsWith("agent:")?t.slice(6):t;return/^[A-Za-z0-9_-]{1,191}$/.test(n)?n:null}async function h(t){try{return await t.json()}catch{return null}}function y(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function d(t,n,e){process.stdout.write(`${JSON.stringify({ok:!1,error:t,message:n,nextAction:e})}
-`),process.exitCode=1}export{k as registerAgentCommand};