shennian 0.5.26 → 0.5.27
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.
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import z from"node:crypto";import q from"node:fs/promises";import x from"node:path";import{getShennianDir as F}from"../config/index.js";import{callDaemonIpc as T}from"../daemon-ipc/client.js";import{DaemonIpcError as S}from"../daemon-ipc/protocol.js";import{PublicAgentClient as j,PublicAgentClientError as D}from"../agents/public-agent-client.js";const J={write:e=>process.stdout.write(e),fail:()=>{process.exitCode=1}};function te(e,t={}){const n=t.client??new j,a=t.io??J,u=t.callDaemon??T;e.command("list").description("List Shennian Agents owned by the paired user on this computer").action(()=>r("agent.list",a,()=>n.list())),e.command("get <agent-id>").description("Read one exact Shennian Agent").action(i=>r("agent.get",a,()=>n.get(c(i,"agent_id_invalid")))),e.command("create").description("Check one local AI configuration, then create a standard full-access Shennian Agent").requiredOption("--name <name>","Agent display name").requiredOption("--description <description>","Public Room introduction").requiredOption("--agent <type>","Exact type returned by agent discover").requiredOption("--workdir <path>","Absolute working directory on this computer").option("--model <id>","Exact model id returned by agent discover").option("--system-prompt <prompt>","Private system prompt","").action(i=>r("agent.create",a,async()=>{const o=E(i);return await I(o,u),n.create(o)})),e.command("share").description("Create a dedicated Agent and publish one usable link").requiredOption("--name <name>","Agent and public display name").requiredOption("--agent <type>","Exact type returned by agent discover").option("--workdir <path>","Working directory; otherwise create an empty private directory").option("--model <id>","Exact model id returned by agent discover").option("--description <description>","Public introduction","").option("--system-prompt <prompt>","Private system prompt","").option("--anonymous","Allow browser-scoped visitors to chat without signing in").action(i=>r("agent.share",a,async()=>{const o=i.workdir?O(i.workdir):await B(),l=E({...i,description:i.description||i.name,workdir:o});await I(l,u);const m=N(await n.create(l)),s=w(m.id,"invalid_server_response");if(await n.createPublicationDraft(s,{displayName:l.displayName,description:l.description,dailyMessageLimit:100}),i.anonymous){const P=v((await n.getPublication(s)).publication,"invalid_server_response");await n.setPublicationAnonymousAccess(s,!0,R(P.generation),R(P.policyVersion))}v((await n.getPublicationReadiness(s)).readiness,"invalid_server_response").activationAvailable!==!0&&d("agent_publication_not_ready",`Agent ${s} was created, but publication is not ready. No link is active.`);const h=v((await n.getPublication(s)).publication,"invalid_server_response");v((await n.activatePublication(s,R(h.generation),R(h.policyVersion))).publication,"invalid_server_response").status!=="active"&&d("agent_publication_inactive",`Agent ${s} was created, but publication is not active.`);const b=v((await n.getPublication(s)).publication,"invalid_server_response");return(b.status!=="active"||typeof b.shareUrl!="string")&&d("agent_publication_unconfirmed",`Agent ${s} was created, but an active share URL could not be confirmed.`),i.anonymous&&b.allowAnonymousVisitors!==!0&&d("agent_publication_guest_unconfirmed",`Agent ${s} was published, but browser guest access could not be confirmed.`),{agentId:s,status:"active",shareUrl:b.shareUrl,visitorAccess:i.anonymous?"browser_guest_allowed":"sign_in_required"}})),e.command("update <agent-id>").description("Update one exact Shennian Agent; runtime changes are checked before saving").option("--name <name>","Agent display name").option("--description <description>","Public Room introduction").option("--agent <type>","Exact type returned by agent discover").option("--workdir <path>","Absolute working directory on this computer").option("--model <id>","Exact model id returned by agent discover").option("--clear-model","Use the runtime default model").option("--system-prompt <prompt>","Private system prompt").action((i,o)=>r("agent.update",a,async()=>{const l=c(i,"agent_id_invalid"),m=G(o);Object.keys(m).length||d("agent_changes_required","Provide at least one Agent field to update.");const s=N(await n.get(l)),y={...s,...m};return M(s)!==M(y)&&await I(y,u),n.update(l,m)})),e.command("delete <agent-id>").description("Delete one exact Shennian Agent and its dedicated Room conversations").action(i=>r("agent.delete",a,()=>n.delete(c(i,"agent_id_invalid"))));const A=e.command("room").description("List, add, or remove this Agent in explicit Rooms");A.command("list <agent-id>").description("List Rooms currently linked to one exact Agent").action(i=>r("agent.room.list",a,()=>n.listRooms(c(i,"agent_id_invalid")))),A.command("add <agent-id> <room-url>").description("Create a dedicated conversation and add this Agent to one explicit Room").option("--mode <mode>","auto_follow, mention_only, or paused","auto_follow").action((i,o,l)=>r("agent.room.add",a,async()=>{const m=c(i,"agent_id_invalid"),s=C(o),y=H(l.mode),h=`cli-agent-room:${z.randomUUID()}`,k=await n.createRoomSession(m,{roomId:s,assignmentIntentId:h,activationMode:y});if(k.existing===!0)return k;const b=v(k.session,"invalid_server_response"),P=w(b.id,"invalid_server_response"),V=w(b.agentType,"invalid_server_response"),$=await u({method:"room.agent.bind-managed",params:{roomId:s,agentIdentityId:m,nianSessionId:P,assignmentIntentId:h,agentType:V,activationMode:y},timeoutMs:12e4});return{session:b,binding:$}})),A.command("remove <agent-id> <room-url>").description("Remove this Agent from one explicit Room and delete its dedicated conversation").action((i,o)=>r("agent.room.remove",a,()=>n.removeFromRoom(c(i,"agent_id_invalid"),C(o))));const _=e.command("publication").description("Manage one Agent publication by exact Agent id");_.command("get <agent-id>").description("Read publication status and versions").action(i=>r("agent.publication.get",a,()=>n.getPublication(c(i,"agent_id_invalid")))),_.command("readiness <agent-id>").description("Read the current machine and runtime checks for one exact Agent publication").action(i=>r("agent.publication.readiness",a,()=>n.getPublicationReadiness(c(i,"agent_id_invalid")))),_.command("draft <agent-id>").description("Create an inactive publication draft; this does not expose a share URL").requiredOption("--name <name>","Public display name").requiredOption("--description <description>","Public introduction").option("--daily-limit <count>","Visitor messages per day","100").action((i,o)=>r("agent.publication.draft",a,()=>n.createPublicationDraft(c(i,"agent_id_invalid"),{displayName:p(o.name,80,"publication_name_invalid",!0),description:p(o.description,1e3,"publication_description_invalid"),dailyMessageLimit:L(o.dailyLimit)}))),_.command("update <agent-id>").description("Update publication details with versions from publication get").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").requiredOption("--name <name>","Public display name").requiredOption("--description <description>","Public introduction").requiredOption("--daily-limit <count>","Visitor messages per day").action((i,o)=>r("agent.publication.update",a,()=>n.updatePublication(c(i,"agent_id_invalid"),{expectedGeneration:g(o.generation,"publication_generation_invalid"),expectedPolicyVersion:g(o.policyVersion,"publication_policy_version_invalid"),displayName:p(o.name,80,"publication_name_invalid",!0),description:p(o.description,1e3,"publication_description_invalid"),dailyMessageLimit:L(o.dailyLimit)}))),_.command("anonymous <agent-id>").description("Enable or disable browser-scoped chats without sign-in on one publication").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").requiredOption("--allowed <value>","true or false").action((i,o)=>r("agent.publication.anonymous",a,()=>n.setPublicationAnonymousAccess(c(i,"agent_id_invalid"),Z(o.allowed),g(o.generation,"publication_generation_invalid"),g(o.policyVersion,"publication_policy_version_invalid")))),_.command("pause <agent-id>").description("Pause an active publication using exact versions").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").action((i,o)=>r("agent.publication.pause",a,()=>n.pausePublication(c(i,"agent_id_invalid"),g(o.generation,"publication_generation_invalid"),g(o.policyVersion,"publication_policy_version_invalid")))),_.command("activate <agent-id>").description("Activate a draft or resume a paused publication only after server release and runtime checks").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").action((i,o)=>r("agent.publication.activate",a,()=>n.activatePublication(c(i,"agent_id_invalid"),g(o.generation,"publication_generation_invalid"),g(o.policyVersion,"publication_policy_version_invalid")))),_.command("revoke <agent-id>").description("Revoke a publication and invalidate its old share URL").requiredOption("--generation <number>","Expected generation").action((i,o)=>r("agent.publication.revoke",a,()=>n.revokePublication(c(i,"agent_id_invalid"),g(o.generation,"publication_generation_invalid")))),_.command("conversations <agent-id>").description("List this publication\u2019s conversations, one page at a time").option("--cursor <cursor>","Opaque next cursor from the previous page").action((i,o)=>r("agent.publication.conversations",a,()=>n.listPublicationConversations(c(i,"agent_id_invalid"),o.cursor)));const f=e.command("public").description("Use the same published Agent URL as a human visitor");f.command("list").description("List your own existing conversations, including history after a link is revoked").option("--cursor <cursor>","Opaque next cursor from the previous page").action(i=>r("agent.public.list",a,()=>n.listMyDirectConversations(i.cursor))),f.command("open <url>").description("Read public Agent details from an exact Shennian share URL").action(i=>r("agent.public.open",a,()=>n.openPublishedAgent(i))),f.command("read <url>").description("Read your latest messages, or page older / follow newer messages").option("--after <cursor>","Read messages after this sequence").option("--before <cursor>","Read older messages before this sequence (default: latest)").action((i,o)=>r("agent.public.read",a,()=>n.readPublishedAgent(i,o))),f.command("history <conversation-id>").description("Read your latest conversation history by stable ID after URL revocation").option("--after <cursor>","Read messages after this sequence").option("--before <cursor>","Read older messages before this sequence (default: latest)").action((i,o)=>r("agent.public.history",a,()=>n.readDirectConversation(c(i,"conversation_id_invalid"),o))),f.command("send <url> <message>").description("Send one message as the paired human user; requires an active publication").requiredOption("--client-message-id <id>","Stable ID for idempotent retries (letters, digits, _ or -)").action((i,o,l)=>r("agent.public.send",a,async()=>{const m=W(l.clientMessageId),s=await n.sendPublishedAgent(i,{text:p(o,2e4,"publication_message_invalid",!0),clientMessageId:m});return{...s,...typeof s.conversationId=="string"?{conversationRef:s.conversationId}:{},clientMessageId:m}}))}function g(e,t){/^[1-9][0-9]*$/.test(e)||d(t,"Use a positive integer.");const n=Number(e);return Number.isSafeInteger(n)||d(t,"Use a positive integer."),n}function L(e){const t=g(e,"publication_daily_limit_invalid");return t>1e3&&d("publication_daily_limit_invalid","Daily limit must be at most 1000."),t}function W(e){return/^[A-Za-z0-9_-]{1,128}$/.test(e)||d("publication_message_id_invalid","Use 1\u2013128 letters, digits, _ or - for --client-message-id."),e}function Z(e){if(e==="true")return!0;if(e==="false")return!1;d("publication_anonymous_invalid","Use true or false for --allowed.")}async function B(){const e=x.join(x.dirname(F()),"shennian-agent-workspaces");await q.mkdir(e,{recursive:!0,mode:448});const t=await q.lstat(e);return(!t.isDirectory()||t.isSymbolicLink())&&d("agent_workdir_invalid","The Agent workspace root is unavailable."),q.mkdtemp(x.join(e,"agent-"))}function R(e){return(typeof e!="number"||!Number.isSafeInteger(e)||e<1)&&d("invalid_server_response","Shennian returned an invalid publication version."),e}function E(e){return{displayName:p(e.name,191,"agent_name_invalid",!0),description:p(e.description,1e3,"agent_description_invalid",!0),runtimeAdapter:p(e.agent,64,"agent_runtime_invalid",!0),workDir:O(e.workdir),modelId:e.model?p(e.model,191,"agent_model_invalid",!0):null,systemPrompt:p(e.systemPrompt,2e4,"agent_system_prompt_invalid")}}function G(e){return e.clearModel&&e.model!==void 0&&d("agent_model_ambiguous","Use either --model or --clear-model, not both."),{...e.name===void 0?{}:{displayName:p(e.name,191,"agent_name_invalid",!0)},...e.description===void 0?{}:{description:p(e.description,1e3,"agent_description_invalid",!0)},...e.agent===void 0?{}:{runtimeAdapter:p(e.agent,64,"agent_runtime_invalid",!0)},...e.workdir===void 0?{}:{workDir:O(e.workdir)},...e.model===void 0&&!e.clearModel?{}:{modelId:e.clearModel?null:p(e.model,191,"agent_model_invalid",!0)},...e.systemPrompt===void 0?{}:{systemPrompt:p(e.systemPrompt,2e4,"agent_system_prompt_invalid")}}}async function I(e,t){const n=w(e.runtimeAdapter,"agent_runtime_invalid"),a=w(e.workDir,"agent_workdir_invalid"),u=typeof e.modelId=="string"?e.modelId:null;if(v(await t({method:"agent.check",params:{agentType:n,workDir:a,modelId:u},timeoutMs:9e4}),"agent_check_invalid_response").ready!==!0)throw new S("agent_check_invalid_response","The daemon did not confirm a successful hello reply.")}function M(e){return JSON.stringify([e.runtimeAdapter??null,e.workDir??null,e.modelId??null,typeof e.systemPrompt=="string"?e.systemPrompt.trim():""])}function N(e){return v(e.agent,"invalid_server_response")}async function r(e,t,n){try{const a=await n();t.write(`${JSON.stringify({ok:!0,command:e,result:a})}
|
|
2
|
-
`)}catch(a){if(a instanceof D){U(
|
|
1
|
+
import T from"node:crypto";import R from"node:fs/promises";import k from"node:path";import{getShennianDir as j}from"../config/index.js";import{callDaemonIpc as z}from"../daemon-ipc/client.js";import{DaemonIpcError as O}from"../daemon-ipc/protocol.js";import{PublicAgentClient as F,PublicAgentClientError as D}from"../agents/public-agent-client.js";const J={write:e=>process.stdout.write(e),fail:()=>{process.exitCode=1}};function te(e,o={}){const t=o.client??new F,a=o.io??J,g=o.callDaemon??z;e.command("list").description("List Shennian Agents owned by the paired user on this computer").action(()=>s("agent.list",a,()=>t.list())),e.command("get <agent-id>").description("Read one exact Shennian Agent").action(i=>s("agent.get",a,()=>t.get(d(i,"agent_id_invalid")))),e.command("create").description("Check one local AI configuration, then create a standard full-access Shennian Agent").requiredOption("--name <name>","Agent display name").requiredOption("--description <description>","Public Room introduction").requiredOption("--agent <type>","Exact type returned by agent discover").requiredOption("--workdir <path>","Absolute working directory on this computer").option("--model <id>","Exact model id returned by agent discover").option("--system-prompt <prompt>","Private system prompt","").action(i=>s("agent.create",a,async()=>{const n=E(i);return await I(n,g),t.create(n)})),e.command("share").description("Publish an existing Agent by --agent-id, or create one and return a usable link").option("--agent-id <id>","Exact id of an existing Shennian Agent").option("--name <name>","New Agent and public display name").option("--agent <type>","New Agent type returned by agent discover").option("--workdir <path>","Working directory; otherwise create an empty private directory").option("--model <id>","Exact model id returned by agent discover").option("--description <description>","Public introduction","").option("--system-prompt <prompt>","Private system prompt","").option("--anonymous","Allow browser-scoped visitors to chat without signing in").action(i=>s("agent.share",a,async()=>{let n="",p;if(i.agentId)(i.name||i.agent||i.workdir||i.model||i.systemPrompt||i.description)&&r("agent_share_ambiguous","Use --agent-id alone for an existing Agent; edit its settings separately."),n=d(i.agentId,"agent_id_invalid"),p=q(await t.get(n)),p.status!=="active"&&r("agent_unavailable","This Agent is not active.");else{(!i.name||!i.agent)&&r("agent_share_selection_required","Provide --agent-id for an existing Agent, or --name and --agent for a new one.");const m=i.workdir?S(i.workdir):await B();p=E({...i,name:i.name,agent:i.agent,systemPrompt:i.systemPrompt??"",description:i.description||i.name,workdir:m})}if(await I(p,g),!i.agentId){const m=q(await t.create(p));n=f(m.id,"invalid_server_response")}const u=i.agentId?(await t.getPublication(n)).publication:null;if((!u||typeof u=="object"&&!Array.isArray(u)&&u.status==="revoked")&&await t.createPublicationDraft(n,{displayName:f(p.displayName,"invalid_server_response"),description:typeof p.description=="string"?p.description:"",dailyMessageLimit:100}),i.anonymous){const m=y(u??(await t.getPublication(n)).publication,"invalid_server_response");m.allowAnonymousVisitors!==!0&&await t.setPublicationAnonymousAccess(n,!0,P(m.generation),P(m.policyVersion))}const l=y((await t.getPublication(n)).publication,"invalid_server_response");if(l.status!=="active"){const m=y((await t.getPublicationReadiness(n)).readiness,"invalid_server_response");m.activationAvailable!==!0&&r("agent_publication_not_ready",`Agent ${n} exists, but cannot be shared yet: ${JSON.stringify(m.blockers??[])}. No usable link was returned.`),y((await t.activatePublication(n,P(l.generation),P(l.policyVersion))).publication,"invalid_server_response").status!=="active"&&r("agent_publication_inactive",`Agent ${n} exists, but publication is not active.`)}const _=y((await t.getPublication(n)).publication,"invalid_server_response");return(_.status!=="active"||typeof _.shareUrl!="string")&&r("agent_publication_unconfirmed",`Agent ${n} was created, but an active share URL could not be confirmed.`),i.anonymous&&_.allowAnonymousVisitors!==!0&&r("agent_publication_guest_unconfirmed",`Agent ${n} was published, but browser guest access could not be confirmed.`),{agentId:n,status:"active",shareUrl:_.shareUrl,visitorAccess:i.anonymous?"browser_guest_allowed":"sign_in_required"}})),e.command("update <agent-id>").description("Update one exact Shennian Agent; runtime changes are checked before saving").option("--name <name>","Agent display name").option("--description <description>","Public Room introduction").option("--agent <type>","Exact type returned by agent discover").option("--workdir <path>","Absolute working directory on this computer").option("--model <id>","Exact model id returned by agent discover").option("--clear-model","Use the runtime default model").option("--system-prompt <prompt>","Private system prompt").action((i,n)=>s("agent.update",a,async()=>{const p=d(i,"agent_id_invalid"),u=G(n);Object.keys(u).length||r("agent_changes_required","Provide at least one Agent field to update.");const l=q(await t.get(p)),_={...l,...u};return N(l)!==N(_)&&await I(_,g),t.update(p,u)})),e.command("delete <agent-id>").description("Delete one exact Shennian Agent and its dedicated Room conversations").action(i=>s("agent.delete",a,()=>t.delete(d(i,"agent_id_invalid"))));const w=e.command("room").description("List, add, or remove this Agent in explicit Rooms");w.command("list <agent-id>").description("List Rooms currently linked to one exact Agent").action(i=>s("agent.room.list",a,()=>t.listRooms(d(i,"agent_id_invalid")))),w.command("add <agent-id> <room-url>").description("Create a dedicated conversation and add this Agent to one explicit Room").option("--mode <mode>","auto_follow, mention_only, or paused","auto_follow").action((i,n,p)=>s("agent.room.add",a,async()=>{const u=d(i,"agent_id_invalid"),l=M(n),_=H(p.mode),m=`cli-agent-room:${T.randomUUID()}`,A=await t.createRoomSession(u,{roomId:l,assignmentIntentId:m,activationMode:_});if(A.existing===!0)return A;const x=y(A.session,"invalid_server_response"),V=f(x.id,"invalid_server_response"),$=f(x.agentType,"invalid_server_response"),C=await g({method:"room.agent.bind-managed",params:{roomId:l,agentIdentityId:u,nianSessionId:V,assignmentIntentId:m,agentType:$,activationMode:_},timeoutMs:12e4});return{session:x,binding:C}})),w.command("remove <agent-id> <room-url>").description("Remove this Agent from one explicit Room and delete its dedicated conversation").action((i,n)=>s("agent.room.remove",a,()=>t.removeFromRoom(d(i,"agent_id_invalid"),M(n))));const v=e.command("publication").description("Manage one Agent publication by exact Agent id");v.command("get <agent-id>").description("Read publication status and versions").action(i=>s("agent.publication.get",a,()=>t.getPublication(d(i,"agent_id_invalid")))),v.command("readiness <agent-id>").description("Read the current machine and runtime checks for one exact Agent publication").action(i=>s("agent.publication.readiness",a,()=>t.getPublicationReadiness(d(i,"agent_id_invalid")))),v.command("draft <agent-id>").description("Create an inactive publication draft; this does not expose a share URL").requiredOption("--name <name>","Public display name").requiredOption("--description <description>","Public introduction").option("--daily-limit <count>","Visitor messages per day","100").action((i,n)=>s("agent.publication.draft",a,()=>t.createPublicationDraft(d(i,"agent_id_invalid"),{displayName:c(n.name,80,"publication_name_invalid",!0),description:c(n.description,1e3,"publication_description_invalid"),dailyMessageLimit:L(n.dailyLimit)}))),v.command("update <agent-id>").description("Update publication details with versions from publication get").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").requiredOption("--name <name>","Public display name").requiredOption("--description <description>","Public introduction").requiredOption("--daily-limit <count>","Visitor messages per day").action((i,n)=>s("agent.publication.update",a,()=>t.updatePublication(d(i,"agent_id_invalid"),{expectedGeneration:b(n.generation,"publication_generation_invalid"),expectedPolicyVersion:b(n.policyVersion,"publication_policy_version_invalid"),displayName:c(n.name,80,"publication_name_invalid",!0),description:c(n.description,1e3,"publication_description_invalid"),dailyMessageLimit:L(n.dailyLimit)}))),v.command("anonymous <agent-id>").description("Enable or disable browser-scoped chats without sign-in on one publication").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").requiredOption("--allowed <value>","true or false").action((i,n)=>s("agent.publication.anonymous",a,()=>t.setPublicationAnonymousAccess(d(i,"agent_id_invalid"),Z(n.allowed),b(n.generation,"publication_generation_invalid"),b(n.policyVersion,"publication_policy_version_invalid")))),v.command("pause <agent-id>").description("Pause an active publication using exact versions").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").action((i,n)=>s("agent.publication.pause",a,()=>t.pausePublication(d(i,"agent_id_invalid"),b(n.generation,"publication_generation_invalid"),b(n.policyVersion,"publication_policy_version_invalid")))),v.command("activate <agent-id>").description("Activate a draft or resume a paused publication only after server release and runtime checks").requiredOption("--generation <number>","Expected generation").requiredOption("--policy-version <number>","Expected policy version").action((i,n)=>s("agent.publication.activate",a,()=>t.activatePublication(d(i,"agent_id_invalid"),b(n.generation,"publication_generation_invalid"),b(n.policyVersion,"publication_policy_version_invalid")))),v.command("revoke <agent-id>").description("Revoke a publication and invalidate its old share URL").requiredOption("--generation <number>","Expected generation").action((i,n)=>s("agent.publication.revoke",a,()=>t.revokePublication(d(i,"agent_id_invalid"),b(n.generation,"publication_generation_invalid")))),v.command("conversations <agent-id>").description("List this publication\u2019s conversations, one page at a time").option("--cursor <cursor>","Opaque next cursor from the previous page").action((i,n)=>s("agent.publication.conversations",a,()=>t.listPublicationConversations(d(i,"agent_id_invalid"),n.cursor)));const h=e.command("public").description("Use the same published Agent URL as a human visitor");h.command("list").description("List your own existing conversations, including history after a link is revoked").option("--cursor <cursor>","Opaque next cursor from the previous page").action(i=>s("agent.public.list",a,()=>t.listMyDirectConversations(i.cursor))),h.command("open <url>").description("Read public Agent details from an exact Shennian share URL").action(i=>s("agent.public.open",a,()=>t.openPublishedAgent(i))),h.command("read <url>").description("Read your latest messages, or page older / follow newer messages").option("--after <cursor>","Read messages after this sequence").option("--before <cursor>","Read older messages before this sequence (default: latest)").action((i,n)=>s("agent.public.read",a,()=>t.readPublishedAgent(i,n))),h.command("history <conversation-id>").description("Read your latest conversation history by stable ID after URL revocation").option("--after <cursor>","Read messages after this sequence").option("--before <cursor>","Read older messages before this sequence (default: latest)").action((i,n)=>s("agent.public.history",a,()=>t.readDirectConversation(d(i,"conversation_id_invalid"),n))),h.command("send <url> <message>").description("Send one message as the paired human user; requires an active publication").requiredOption("--client-message-id <id>","Stable ID for idempotent retries (letters, digits, _ or -)").action((i,n,p)=>s("agent.public.send",a,async()=>{const u=W(p.clientMessageId),l=await t.sendPublishedAgent(i,{text:c(n,2e4,"publication_message_invalid",!0),clientMessageId:u});return{...l,...typeof l.conversationId=="string"?{conversationRef:l.conversationId}:{},clientMessageId:u}}))}function b(e,o){/^[1-9][0-9]*$/.test(e)||r(o,"Use a positive integer.");const t=Number(e);return Number.isSafeInteger(t)||r(o,"Use a positive integer."),t}function L(e){const o=b(e,"publication_daily_limit_invalid");return o>1e3&&r("publication_daily_limit_invalid","Daily limit must be at most 1000."),o}function W(e){return/^[A-Za-z0-9_-]{1,128}$/.test(e)||r("publication_message_id_invalid","Use 1\u2013128 letters, digits, _ or - for --client-message-id."),e}function Z(e){if(e==="true")return!0;if(e==="false")return!1;r("publication_anonymous_invalid","Use true or false for --allowed.")}async function B(){const e=k.join(k.dirname(j()),"shennian-agent-workspaces");await R.mkdir(e,{recursive:!0,mode:448});const o=await R.lstat(e);return(!o.isDirectory()||o.isSymbolicLink())&&r("agent_workdir_invalid","The Agent workspace root is unavailable."),R.mkdtemp(k.join(e,"agent-"))}function P(e){return(typeof e!="number"||!Number.isSafeInteger(e)||e<1)&&r("invalid_server_response","Shennian returned an invalid publication version."),e}function E(e){return{displayName:c(e.name,191,"agent_name_invalid",!0),description:c(e.description,1e3,"agent_description_invalid",!0),runtimeAdapter:c(e.agent,64,"agent_runtime_invalid",!0),workDir:S(e.workdir),modelId:e.model?c(e.model,191,"agent_model_invalid",!0):null,systemPrompt:c(e.systemPrompt,2e4,"agent_system_prompt_invalid")}}function G(e){return e.clearModel&&e.model!==void 0&&r("agent_model_ambiguous","Use either --model or --clear-model, not both."),{...e.name===void 0?{}:{displayName:c(e.name,191,"agent_name_invalid",!0)},...e.description===void 0?{}:{description:c(e.description,1e3,"agent_description_invalid",!0)},...e.agent===void 0?{}:{runtimeAdapter:c(e.agent,64,"agent_runtime_invalid",!0)},...e.workdir===void 0?{}:{workDir:S(e.workdir)},...e.model===void 0&&!e.clearModel?{}:{modelId:e.clearModel?null:c(e.model,191,"agent_model_invalid",!0)},...e.systemPrompt===void 0?{}:{systemPrompt:c(e.systemPrompt,2e4,"agent_system_prompt_invalid")}}}async function I(e,o){const t=f(e.runtimeAdapter,"agent_runtime_invalid"),a=f(e.workDir,"agent_workdir_invalid"),g=typeof e.modelId=="string"?e.modelId:null;if(y(await o({method:"agent.check",params:{agentType:t,workDir:a,modelId:g},timeoutMs:9e4}),"agent_check_invalid_response").ready!==!0)throw new O("agent_check_invalid_response","The daemon did not confirm a successful hello reply.")}function N(e){return JSON.stringify([e.runtimeAdapter??null,e.workDir??null,e.modelId??null,typeof e.systemPrompt=="string"?e.systemPrompt.trim():""])}function q(e){return y(e.agent,"invalid_server_response")}async function s(e,o,t){try{const a=await t();o.write(`${JSON.stringify({ok:!0,command:e,result:a})}
|
|
2
|
+
`)}catch(a){if(a instanceof D){U(o,a.code,a.message,a.nextAction);return}if(a instanceof O){U(o,a.code,a.message,null);return}U(o,"agent_command_failed","Shennian Agent command failed.",null)}}function d(e,o){return/^[A-Za-z0-9_.:@/-]{1,191}$/.test(e)||r(o,"Use the exact Agent id returned by Shennian."),e}function M(e){let o;try{o=new URL(e)}catch{r("invalid_room_ref","Use an official Room URL returned by Shennian.")}const t=o.pathname.match(/^\/spaces\/([A-Za-z0-9_-]{1,191})$/);return(o.protocol!=="https:"||o.hostname!=="app.shennian.net"||o.port||o.username||o.password||o.hash||o.search||!t)&&r("invalid_room_ref","Use an official Room URL returned by Shennian."),t[1]}function H(e){if(e==="auto_follow"||e==="mention_only"||e==="paused")return e;r("invalid_activation_mode","--mode must be auto_follow, mention_only, or paused.")}function S(e){const o=c(e,1024,"agent_workdir_invalid",!0);return k.isAbsolute(o)||r("agent_workdir_invalid","Use an absolute working directory."),o}function c(e,o,t,a=!1){const g=typeof e=="string"?e.trim():"";return(a&&!g||g.length>o||g.includes("\0"))&&r(t,"Agent field is invalid."),g}function f(e,o){return(typeof e!="string"||!e)&&r(o,"Shennian returned an invalid Agent response."),e}function y(e,o){return(!e||typeof e!="object"||Array.isArray(e))&&r(o,"Shennian returned an invalid Agent response."),e}function r(e,o){throw new D(e,o)}function U(e,o,t,a){e.write(`${JSON.stringify({ok:!1,error:o,message:t,nextAction:a})}
|
|
3
3
|
`),e.fail()}export{te as registerAgentWorkspaceCommands};
|