@tianshu-ai/tianshu 0.4.0 → 0.4.1

package/node_modules/@tianshu-ai/plugin-sdk/dist/capabilities.d.ts

@@ -43,6 +43,10 @@ export declare const KNOWN_CAPABILITIES: {
         readonly exclusive: true;
         readonly description: "Manage channel adapter bindings (chat-platform integrations). Plugins contributing a channel (Feishu / Telegram / WeChat / ...) call create/start/stop/delete here so the host's adapter manager actually wires the inbound stream to the agent. The DB row + adapter lifecycle live together behind this capability.";
     };
+    readonly "host.workforceSnapshot": {
+        readonly exclusive: true;
+        readonly description: "Build a read-only snapshot of the tenant's agent configuration (main agent prompt + tools + skills, every worker agent's prompt + allowed tools + allowed skills). Used by the Workforce Studio plugin to render an inspect-and-export UI; the snapshot includes full skill markdown bodies so the studio can ship a faithful bundle.";
+    };
 };
 export type CapabilityName = keyof typeof KNOWN_CAPABILITIES;
 /** True iff the given string is a registered capability name. */

package/node_modules/@tianshu-ai/plugin-sdk/dist/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDoB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE7D,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,cAAc,CAE/D;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDoB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE7D,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,cAAc,CAE/D;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE"}

package/node_modules/@tianshu-ai/plugin-sdk/dist/capabilities.js

@@ -53,6 +53,10 @@ export const KNOWN_CAPABILITIES = {
         exclusive: true,
         description: "Manage channel adapter bindings (chat-platform integrations). Plugins contributing a channel (Feishu / Telegram / WeChat / ...) call create/start/stop/delete here so the host's adapter manager actually wires the inbound stream to the agent. The DB row + adapter lifecycle live together behind this capability.",
     },
+    "host.workforceSnapshot": {
+        exclusive: true,
+        description: "Build a read-only snapshot of the tenant's agent configuration (main agent prompt + tools + skills, every worker agent's prompt + allowed tools + allowed skills). Used by the Workforce Studio plugin to render an inspect-and-export UI; the snapshot includes full skill markdown bodies so the studio can ship a faithful bundle.",
+    },
 };
 /** True iff the given string is a registered capability name. */
 export function isCapabilityName(s) {

package/node_modules/@tianshu-ai/plugin-sdk/dist/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,sEAAsE;AACtE,oEAAoE;AACpE,0DAA0D;AAC1D,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,+DAA+D;AAC/D,mCAAmC;AACnC,kEAAkE;AAClE,2DAA2D;AAO3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EACT,8EAA8E;KACjF;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0SAA0S;KAC7S;IACD,aAAa,EAAE;QACb,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0HAA0H;KAC7H;IACD,gBAAgB,EAAE;QAChB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sWAAsW;KACzW;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,qTAAqT;KACxT;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,oNAAoN;KACvN;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sRAAsR;KACzR;IACD,UAAU,EAAE;QACV,SAAS,EAAE,IAAI;QACf,WAAW,EACT,iXAAiX;KACpX;IACD,sBAAsB,EAAE;QACtB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;CACgD,CAAC;AAIpD,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,sEAAsE;AACtE,oEAAoE;AACpE,0DAA0D;AAC1D,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,+DAA+D;AAC/D,mCAAmC;AACnC,kEAAkE;AAClE,2DAA2D;AAO3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EACT,8EAA8E;KACjF;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0SAA0S;KAC7S;IACD,aAAa,EAAE;QACb,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0HAA0H;KAC7H;IACD,gBAAgB,EAAE;QAChB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sWAAsW;KACzW;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,qTAAqT;KACxT;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,oNAAoN;KACvN;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sRAAsR;KACzR;IACD,UAAU,EAAE;QACV,SAAS,EAAE,IAAI;QACf,WAAW,EACT,iXAAiX;KACpX;IACD,sBAAsB,EAAE;QACtB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;IACD,wBAAwB,EAAE;QACxB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uUAAuU;KAC1U;CACgD,CAAC;AAIpD,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/node_modules/@tianshu-ai/plugin-sdk/dist/index.d.ts

@@ -6,5 +6,6 @@ export * from "./session-inbox.js";
 export * from "./catalog.js";
 export * from "./lsp.js";
 export * from "./channel-bindings.js";
+export * from "./workforce-snapshot.js";
 export { McpToolset, textOfMcpContent, type McpEndpointResolver, type McpToolDescriptor, type McpToolFilter, type McpToolsetEntry, type McpToolsetOptions, type McpToolsetSnapshot, type ToolsetProvider, } from "./mcp-toolset.js";
 //# sourceMappingURL=index.d.ts.map

package/node_modules/@tianshu-ai/plugin-sdk/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}

package/node_modules/@tianshu-ai/plugin-sdk/dist/index.js

@@ -16,5 +16,6 @@ export * from "./session-inbox.js";
 export * from "./catalog.js";
 export * from "./lsp.js";
 export * from "./channel-bindings.js";
+export * from "./workforce-snapshot.js";
 export { McpToolset, textOfMcpContent, } from "./mcp-toolset.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@tianshu-ai/plugin-sdk/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,qEAAqE;AACrE,iCAAiC;AACjC,EAAE;AACF,wEAAwE;AACxE,iEAAiE;AACjE,0BAA0B;AAE1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,UAAU,EACV,gBAAgB,GAQjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,qEAAqE;AACrE,iCAAiC;AACjC,EAAE;AACF,wEAAwE;AACxE,iEAAiE;AACjE,0BAA0B;AAE1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,UAAU,EACV,gBAAgB,GAQjB,MAAM,kBAAkB,CAAC"}

package/node_modules/@tianshu-ai/plugin-sdk/dist/workforce-snapshot.d.ts

@@ -0,0 +1,116 @@
+/** Tool the agent has access to, with enough detail to render a
+ *  studio detail panel + write a `tools.md` entry in the zip. */
+export interface WorkforceToolEntry {
+    /** Schema name the model calls. */
+    name: string;
+    /** One-line description from the tool's schema. */
+    description: string;
+    /** JSON schema for the tool's parameters, exactly as the model
+     *  sees it. Studio renders this for documentation. */
+    parameters: unknown;
+    /** Plugin that contributes the tool, or "core" for host-owned
+     *  tools like worker_analytics. */
+    pluginId: string;
+    /** Manifest `since` version (string semver). null when the
+     *  plugin didn't declare it. */
+    since: string | null;
+}
+/** Skill the agent has access to. Includes the markdown body so
+ *  the zip export can reproduce the file the agent reads when it
+ *  decides to load the skill. */
+export interface WorkforceSkillEntry {
+    /** Frontmatter `name`. Unique across enabled skills. */
+    name: string;
+    /** Frontmatter `description`. */
+    description: string;
+    /** Plugin id that owns the contribution, or "host" for
+     *  built-in skills shipped under packages/server/host-skills. */
+    pluginId: string;
+    /** "main" / "worker" / undefined (visible to both). */
+    scope?: "main" | "worker";
+    /** Path of the skill file as seen by the agent. Studio mirrors
+     *  this into the zip under `skills/<path>` so the export is a
+     *  faithful reproduction of what the model reads. */
+    relativePath: string;
+    /** Full markdown body, frontmatter included. */
+    body: string;
+}
+export interface WorkforceMainAgent {
+    /** Brand name from tenant config. */
+    brandName: string;
+    /** Default model id (provider-prefixed). May be null when the
+     *  tenant has no models configured. */
+    defaultModelId: string | null;
+    /** Composed system prompt the agent would receive on the next
+     *  turn if it ran right now. Includes plugin fragments + the
+     *  current skill catalog block; static enough to diff across
+     *  upgrades. */
+    systemPrompt: string;
+    /** Every tool currently visible to the main agent. Already
+     *  filtered for `available()` and skill-aware gating. */
+    tools: WorkforceToolEntry[];
+    /** Every skill visible to the main agent after
+     *  scope/when filtering. */
+    skills: WorkforceSkillEntry[];
+}
+export interface WorkforceWorkerAgent {
+    /** Slug (directory name under
+     *  `_tenant/config/workers/<slug>/`). Used as the agent id
+     *  everywhere else in the system. */
+    slug: string;
+    /** Display name from the worker's agent.json. */
+    name: string;
+    /** One-line description from agent.json. */
+    description: string | null;
+    /** Functional category (default-llm / code / research / ...). */
+    kind: string;
+    /** "builtin" or "user" — user-authored workers can be edited;
+     *  builtins are the ones the host ships and the studio surfaces
+     *  read-only. */
+    source: "builtin" | "user";
+    /** Whether the workboard pool actually dispatches to this
+     *  worker. Disabled workers still appear in the studio so admins
+     *  can inspect why they aren't running. */
+    enabled: boolean;
+    /** Bound model id, or null when the worker uses whatever the
+     *  pool/agent loop picks. */
+    modelId: string | null;
+    /** Composed system prompt the worker actually runs with.
+     *  Comparable to WorkforceMainAgent.systemPrompt but built
+     *  via the workboard's worker prompt logic. */
+    systemPrompt: string;
+    /** Tools the worker is allowed to call after WORKER_DENY_TOOLS
+     *  + agent.json toolsAllow filtering. */
+    tools: WorkforceToolEntry[];
+    /** Skills the worker can load (agent.json `skills:` allow-list
+     *  intersected with the host catalog, scope-filtered for
+     *  worker visibility). */
+    skills: WorkforceSkillEntry[];
+}
+export interface WorkforceSnapshot {
+    /** Tenant id this snapshot represents. */
+    tenantId: string;
+    /** User id this snapshot represents. Per-user surfaces (chat
+     *  user prompt, etc.) are pinned to this id. */
+    userId: string;
+    /** ms epoch when the host built the snapshot. */
+    generatedAt: number;
+    /** Tianshu version that produced the snapshot. Surfaced in the
+     *  zip's README so future re-imports know what era the export
+     *  belongs to. */
+    tianshuVersion: string;
+    main: WorkforceMainAgent;
+    workers: WorkforceWorkerAgent[];
+}
+export interface WorkforceSnapshotCapability {
+    /** Build a complete snapshot of the tenant's agent configuration
+     *  for the given user. Synchronous — every dependency is
+     *  already in memory or backed by quick fs reads.
+     *
+     *  The userId pins per-user context (user home AGENTS/SOUL/USER
+     *  blocks the agent would actually see), so callers must pass it
+     *  through from the authenticated request rather than letting
+     *  the capability default. */
+    build(userId: string): WorkforceSnapshot;
+}
+//# sourceMappingURL=workforce-snapshot.d.ts.map

package/node_modules/@tianshu-ai/plugin-sdk/dist/workforce-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workforce-snapshot.d.ts","sourceRoot":"","sources":["../src/workforce-snapshot.ts"],"names":[],"mappings":"AAiBA;iEACiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB;0DACsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB;uCACmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB;oCACgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;iCAEiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;qEACiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B;;yDAEqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB;2CACuC;IACvC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;oBAGgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB;6DACyD;IACzD,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B;gCAC4B;IAC5B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC;;yCAEqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb;;qBAEiB;IACjB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B;;+CAE2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB;iCAC6B;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;mDAE+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB;6CACyC;IACzC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B;;8BAE0B;IAC1B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB;oDACgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB;;sBAEkB;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;kCAO8B;IAC9B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC1C"}

package/node_modules/@tianshu-ai/plugin-sdk/dist/workforce-snapshot.js

@@ -0,0 +1,18 @@
+// Capability shape for `host.workforceSnapshot` — used by the
+// Workforce Studio plugin to introspect + export the tenant's
+// agent configuration in one call.
+//
+// The host returns a complete read-only snapshot covering:
+//   - the main agent's identity (brand, default model) + the
+//     skills it actually sees (after scope/when filtering)
+//   - every active tool's schema, source plugin, and since
+//     version
+//   - every worker agent's prompt, allowed tools, allowed skills
+//
+// Unlike the catalog capabilities (host.toolCatalog,
+// host.skillCatalog) this surface includes the FULL skill body
+// so the studio's zip export can ship every skill .md file as
+// part of the bundle. The catalog capabilities stay slim for
+// the cases that only need names + descriptions.
+export {};
+//# sourceMappingURL=workforce-snapshot.js.map

package/node_modules/@tianshu-ai/plugin-sdk/dist/workforce-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workforce-snapshot.js","sourceRoot":"","sources":["../src/workforce-snapshot.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,8DAA8D;AAC9D,mCAAmC;AACnC,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,2DAA2D;AAC3D,2DAA2D;AAC3D,cAAc;AACd,iEAAiE;AACjE,EAAE;AACF,qDAAqD;AACrD,+DAA+D;AAC/D,8DAA8D;AAC9D,6DAA6D;AAC7D,iDAAiD"}

package/node_modules/@tianshu-ai/plugin-sdk/src/capabilities.ts

@@ -69,6 +69,11 @@ export const KNOWN_CAPABILITIES = {
     description:
       "Manage channel adapter bindings (chat-platform integrations). Plugins contributing a channel (Feishu / Telegram / WeChat / ...) call create/start/stop/delete here so the host's adapter manager actually wires the inbound stream to the agent. The DB row + adapter lifecycle live together behind this capability.",
   },
+  "host.workforceSnapshot": {
+    exclusive: true,
+    description:
+      "Build a read-only snapshot of the tenant's agent configuration (main agent prompt + tools + skills, every worker agent's prompt + allowed tools + allowed skills). Used by the Workforce Studio plugin to render an inspect-and-export UI; the snapshot includes full skill markdown bodies so the studio can ship a faithful bundle.",
+  },
 } as const satisfies Record<string, CapabilitySpec>;
 
 export type CapabilityName = keyof typeof KNOWN_CAPABILITIES;

package/node_modules/@tianshu-ai/plugin-sdk/src/index.ts

@@ -17,6 +17,7 @@ export * from "./session-inbox.js";
 export * from "./catalog.js";
 export * from "./lsp.js";
 export * from "./channel-bindings.js";
+export * from "./workforce-snapshot.js";
 export {
   McpToolset,
   textOfMcpContent,

package/node_modules/@tianshu-ai/plugin-sdk/src/workforce-snapshot.ts

@@ -0,0 +1,137 @@
+// Capability shape for `host.workforceSnapshot` — used by the
+// Workforce Studio plugin to introspect + export the tenant's
+// agent configuration in one call.
+//
+// The host returns a complete read-only snapshot covering:
+//   - the main agent's identity (brand, default model) + the
+//     skills it actually sees (after scope/when filtering)
+//   - every active tool's schema, source plugin, and since
+//     version
+//   - every worker agent's prompt, allowed tools, allowed skills
+//
+// Unlike the catalog capabilities (host.toolCatalog,
+// host.skillCatalog) this surface includes the FULL skill body
+// so the studio's zip export can ship every skill .md file as
+// part of the bundle. The catalog capabilities stay slim for
+// the cases that only need names + descriptions.
+
+/** Tool the agent has access to, with enough detail to render a
+ *  studio detail panel + write a `tools.md` entry in the zip. */
+export interface WorkforceToolEntry {
+  /** Schema name the model calls. */
+  name: string;
+  /** One-line description from the tool's schema. */
+  description: string;
+  /** JSON schema for the tool's parameters, exactly as the model
+   *  sees it. Studio renders this for documentation. */
+  parameters: unknown;
+  /** Plugin that contributes the tool, or "core" for host-owned
+   *  tools like worker_analytics. */
+  pluginId: string;
+  /** Manifest `since` version (string semver). null when the
+   *  plugin didn't declare it. */
+  since: string | null;
+}
+
+/** Skill the agent has access to. Includes the markdown body so
+ *  the zip export can reproduce the file the agent reads when it
+ *  decides to load the skill. */
+export interface WorkforceSkillEntry {
+  /** Frontmatter `name`. Unique across enabled skills. */
+  name: string;
+  /** Frontmatter `description`. */
+  description: string;
+  /** Plugin id that owns the contribution, or "host" for
+   *  built-in skills shipped under packages/server/host-skills. */
+  pluginId: string;
+  /** "main" / "worker" / undefined (visible to both). */
+  scope?: "main" | "worker";
+  /** Path of the skill file as seen by the agent. Studio mirrors
+   *  this into the zip under `skills/<path>` so the export is a
+   *  faithful reproduction of what the model reads. */
+  relativePath: string;
+  /** Full markdown body, frontmatter included. */
+  body: string;
+}
+
+export interface WorkforceMainAgent {
+  /** Brand name from tenant config. */
+  brandName: string;
+  /** Default model id (provider-prefixed). May be null when the
+   *  tenant has no models configured. */
+  defaultModelId: string | null;
+  /** Composed system prompt the agent would receive on the next
+   *  turn if it ran right now. Includes plugin fragments + the
+   *  current skill catalog block; static enough to diff across
+   *  upgrades. */
+  systemPrompt: string;
+  /** Every tool currently visible to the main agent. Already
+   *  filtered for `available()` and skill-aware gating. */
+  tools: WorkforceToolEntry[];
+  /** Every skill visible to the main agent after
+   *  scope/when filtering. */
+  skills: WorkforceSkillEntry[];
+}
+
+export interface WorkforceWorkerAgent {
+  /** Slug (directory name under
+   *  `_tenant/config/workers/<slug>/`). Used as the agent id
+   *  everywhere else in the system. */
+  slug: string;
+  /** Display name from the worker's agent.json. */
+  name: string;
+  /** One-line description from agent.json. */
+  description: string | null;
+  /** Functional category (default-llm / code / research / ...). */
+  kind: string;
+  /** "builtin" or "user" — user-authored workers can be edited;
+   *  builtins are the ones the host ships and the studio surfaces
+   *  read-only. */
+  source: "builtin" | "user";
+  /** Whether the workboard pool actually dispatches to this
+   *  worker. Disabled workers still appear in the studio so admins
+   *  can inspect why they aren't running. */
+  enabled: boolean;
+  /** Bound model id, or null when the worker uses whatever the
+   *  pool/agent loop picks. */
+  modelId: string | null;
+  /** Composed system prompt the worker actually runs with.
+   *  Comparable to WorkforceMainAgent.systemPrompt but built
+   *  via the workboard's worker prompt logic. */
+  systemPrompt: string;
+  /** Tools the worker is allowed to call after WORKER_DENY_TOOLS
+   *  + agent.json toolsAllow filtering. */
+  tools: WorkforceToolEntry[];
+  /** Skills the worker can load (agent.json `skills:` allow-list
+   *  intersected with the host catalog, scope-filtered for
+   *  worker visibility). */
+  skills: WorkforceSkillEntry[];
+}
+
+export interface WorkforceSnapshot {
+  /** Tenant id this snapshot represents. */
+  tenantId: string;
+  /** User id this snapshot represents. Per-user surfaces (chat
+   *  user prompt, etc.) are pinned to this id. */
+  userId: string;
+  /** ms epoch when the host built the snapshot. */
+  generatedAt: number;
+  /** Tianshu version that produced the snapshot. Surfaced in the
+   *  zip's README so future re-imports know what era the export
+   *  belongs to. */
+  tianshuVersion: string;
+  main: WorkforceMainAgent;
+  workers: WorkforceWorkerAgent[];
+}
+
+export interface WorkforceSnapshotCapability {
+  /** Build a complete snapshot of the tenant's agent configuration
+   *  for the given user. Synchronous — every dependency is
+   *  already in memory or backed by quick fs reads.
+   *
+   *  The userId pins per-user context (user home AGENTS/SOUL/USER
+   *  blocks the agent would actually see), so callers must pass it
+   *  through from the authenticated request rather than letting
+   *  the capability default. */
+  build(userId: string): WorkforceSnapshot;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tianshu-ai/tianshu",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "An open AI agent platform with a sidecar browser. Built in public.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/tianshu-ai/tianshu",

package/packages/plugin-sdk/dist/capabilities.d.ts

@@ -43,6 +43,10 @@ export declare const KNOWN_CAPABILITIES: {
         readonly exclusive: true;
         readonly description: "Manage channel adapter bindings (chat-platform integrations). Plugins contributing a channel (Feishu / Telegram / WeChat / ...) call create/start/stop/delete here so the host's adapter manager actually wires the inbound stream to the agent. The DB row + adapter lifecycle live together behind this capability.";
     };
+    readonly "host.workforceSnapshot": {
+        readonly exclusive: true;
+        readonly description: "Build a read-only snapshot of the tenant's agent configuration (main agent prompt + tools + skills, every worker agent's prompt + allowed tools + allowed skills). Used by the Workforce Studio plugin to render an inspect-and-export UI; the snapshot includes full skill markdown bodies so the studio can ship a faithful bundle.";
+    };
 };
 export type CapabilityName = keyof typeof KNOWN_CAPABILITIES;
 /** True iff the given string is a registered capability name. */

package/packages/plugin-sdk/dist/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDoB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE7D,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,cAAc,CAE/D;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDoB,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE7D,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,cAAc,CAE/D;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE"}

package/packages/plugin-sdk/dist/capabilities.js

@@ -53,6 +53,10 @@ export const KNOWN_CAPABILITIES = {
         exclusive: true,
         description: "Manage channel adapter bindings (chat-platform integrations). Plugins contributing a channel (Feishu / Telegram / WeChat / ...) call create/start/stop/delete here so the host's adapter manager actually wires the inbound stream to the agent. The DB row + adapter lifecycle live together behind this capability.",
     },
+    "host.workforceSnapshot": {
+        exclusive: true,
+        description: "Build a read-only snapshot of the tenant's agent configuration (main agent prompt + tools + skills, every worker agent's prompt + allowed tools + allowed skills). Used by the Workforce Studio plugin to render an inspect-and-export UI; the snapshot includes full skill markdown bodies so the studio can ship a faithful bundle.",
+    },
 };
 /** True iff the given string is a registered capability name. */
 export function isCapabilityName(s) {

package/packages/plugin-sdk/dist/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,sEAAsE;AACtE,oEAAoE;AACpE,0DAA0D;AAC1D,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,+DAA+D;AAC/D,mCAAmC;AACnC,kEAAkE;AAClE,2DAA2D;AAO3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EACT,8EAA8E;KACjF;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0SAA0S;KAC7S;IACD,aAAa,EAAE;QACb,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0HAA0H;KAC7H;IACD,gBAAgB,EAAE;QAChB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sWAAsW;KACzW;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,qTAAqT;KACxT;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,oNAAoN;KACvN;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sRAAsR;KACzR;IACD,UAAU,EAAE;QACV,SAAS,EAAE,IAAI;QACf,WAAW,EACT,iXAAiX;KACpX;IACD,sBAAsB,EAAE;QACtB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;CACgD,CAAC;AAIpD,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,sEAAsE;AACtE,oEAAoE;AACpE,0DAA0D;AAC1D,EAAE;AACF,mBAAmB;AACnB,kEAAkE;AAClE,+DAA+D;AAC/D,mCAAmC;AACnC,kEAAkE;AAClE,2DAA2D;AAO3D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,eAAe,EAAE;QACf,SAAS,EAAE,IAAI;QACf,WAAW,EACT,8EAA8E;KACjF;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0SAA0S;KAC7S;IACD,aAAa,EAAE;QACb,SAAS,EAAE,IAAI;QACf,WAAW,EACT,0HAA0H;KAC7H;IACD,gBAAgB,EAAE;QAChB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sWAAsW;KACzW;IACD,kBAAkB,EAAE;QAClB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,qTAAqT;KACxT;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,oNAAoN;KACvN;IACD,mBAAmB,EAAE;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,sRAAsR;KACzR;IACD,UAAU,EAAE;QACV,SAAS,EAAE,IAAI;QACf,WAAW,EACT,iXAAiX;KACpX;IACD,sBAAsB,EAAE;QACtB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uTAAuT;KAC1T;IACD,wBAAwB,EAAE;QACxB,SAAS,EAAE,IAAI;QACf,WAAW,EACT,uUAAuU;KAC1U;CACgD,CAAC;AAIpD,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/packages/plugin-sdk/dist/index.d.ts

@@ -6,5 +6,6 @@ export * from "./session-inbox.js";
 export * from "./catalog.js";
 export * from "./lsp.js";
 export * from "./channel-bindings.js";
+export * from "./workforce-snapshot.js";
 export { McpToolset, textOfMcpContent, type McpEndpointResolver, type McpToolDescriptor, type McpToolFilter, type McpToolsetEntry, type McpToolsetOptions, type McpToolsetSnapshot, type ToolsetProvider, } from "./mcp-toolset.js";
 //# sourceMappingURL=index.d.ts.map

package/packages/plugin-sdk/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}

package/packages/plugin-sdk/dist/index.js

@@ -16,5 +16,6 @@ export * from "./session-inbox.js";
 export * from "./catalog.js";
 export * from "./lsp.js";
 export * from "./channel-bindings.js";
+export * from "./workforce-snapshot.js";
 export { McpToolset, textOfMcpContent, } from "./mcp-toolset.js";
 //# sourceMappingURL=index.js.map

package/packages/plugin-sdk/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,qEAAqE;AACrE,iCAAiC;AACjC,EAAE;AACF,wEAAwE;AACxE,iEAAiE;AACjE,0BAA0B;AAE1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,UAAU,EACV,gBAAgB,GAQjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,qEAAqE;AACrE,iCAAiC;AACjC,EAAE;AACF,wEAAwE;AACxE,iEAAiE;AACjE,0BAA0B;AAE1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EACL,UAAU,EACV,gBAAgB,GAQjB,MAAM,kBAAkB,CAAC"}

package/packages/plugin-sdk/dist/workforce-snapshot.d.ts

@@ -0,0 +1,116 @@
+/** Tool the agent has access to, with enough detail to render a
+ *  studio detail panel + write a `tools.md` entry in the zip. */
+export interface WorkforceToolEntry {
+    /** Schema name the model calls. */
+    name: string;
+    /** One-line description from the tool's schema. */
+    description: string;
+    /** JSON schema for the tool's parameters, exactly as the model
+     *  sees it. Studio renders this for documentation. */
+    parameters: unknown;
+    /** Plugin that contributes the tool, or "core" for host-owned
+     *  tools like worker_analytics. */
+    pluginId: string;
+    /** Manifest `since` version (string semver). null when the
+     *  plugin didn't declare it. */
+    since: string | null;
+}
+/** Skill the agent has access to. Includes the markdown body so
+ *  the zip export can reproduce the file the agent reads when it
+ *  decides to load the skill. */
+export interface WorkforceSkillEntry {
+    /** Frontmatter `name`. Unique across enabled skills. */
+    name: string;
+    /** Frontmatter `description`. */
+    description: string;
+    /** Plugin id that owns the contribution, or "host" for
+     *  built-in skills shipped under packages/server/host-skills. */
+    pluginId: string;
+    /** "main" / "worker" / undefined (visible to both). */
+    scope?: "main" | "worker";
+    /** Path of the skill file as seen by the agent. Studio mirrors
+     *  this into the zip under `skills/<path>` so the export is a
+     *  faithful reproduction of what the model reads. */
+    relativePath: string;
+    /** Full markdown body, frontmatter included. */
+    body: string;
+}
+export interface WorkforceMainAgent {
+    /** Brand name from tenant config. */
+    brandName: string;
+    /** Default model id (provider-prefixed). May be null when the
+     *  tenant has no models configured. */
+    defaultModelId: string | null;
+    /** Composed system prompt the agent would receive on the next
+     *  turn if it ran right now. Includes plugin fragments + the
+     *  current skill catalog block; static enough to diff across
+     *  upgrades. */
+    systemPrompt: string;
+    /** Every tool currently visible to the main agent. Already
+     *  filtered for `available()` and skill-aware gating. */
+    tools: WorkforceToolEntry[];
+    /** Every skill visible to the main agent after
+     *  scope/when filtering. */
+    skills: WorkforceSkillEntry[];
+}
+export interface WorkforceWorkerAgent {
+    /** Slug (directory name under
+     *  `_tenant/config/workers/<slug>/`). Used as the agent id
+     *  everywhere else in the system. */
+    slug: string;
+    /** Display name from the worker's agent.json. */
+    name: string;
+    /** One-line description from agent.json. */
+    description: string | null;
+    /** Functional category (default-llm / code / research / ...). */
+    kind: string;
+    /** "builtin" or "user" — user-authored workers can be edited;
+     *  builtins are the ones the host ships and the studio surfaces
+     *  read-only. */
+    source: "builtin" | "user";
+    /** Whether the workboard pool actually dispatches to this
+     *  worker. Disabled workers still appear in the studio so admins
+     *  can inspect why they aren't running. */
+    enabled: boolean;
+    /** Bound model id, or null when the worker uses whatever the
+     *  pool/agent loop picks. */
+    modelId: string | null;
+    /** Composed system prompt the worker actually runs with.
+     *  Comparable to WorkforceMainAgent.systemPrompt but built
+     *  via the workboard's worker prompt logic. */
+    systemPrompt: string;
+    /** Tools the worker is allowed to call after WORKER_DENY_TOOLS
+     *  + agent.json toolsAllow filtering. */
+    tools: WorkforceToolEntry[];
+    /** Skills the worker can load (agent.json `skills:` allow-list
+     *  intersected with the host catalog, scope-filtered for
+     *  worker visibility). */
+    skills: WorkforceSkillEntry[];
+}
+export interface WorkforceSnapshot {
+    /** Tenant id this snapshot represents. */
+    tenantId: string;
+    /** User id this snapshot represents. Per-user surfaces (chat
+     *  user prompt, etc.) are pinned to this id. */
+    userId: string;
+    /** ms epoch when the host built the snapshot. */
+    generatedAt: number;
+    /** Tianshu version that produced the snapshot. Surfaced in the
+     *  zip's README so future re-imports know what era the export
+     *  belongs to. */
+    tianshuVersion: string;
+    main: WorkforceMainAgent;
+    workers: WorkforceWorkerAgent[];
+}
+export interface WorkforceSnapshotCapability {
+    /** Build a complete snapshot of the tenant's agent configuration
+     *  for the given user. Synchronous — every dependency is
+     *  already in memory or backed by quick fs reads.
+     *
+     *  The userId pins per-user context (user home AGENTS/SOUL/USER
+     *  blocks the agent would actually see), so callers must pass it
+     *  through from the authenticated request rather than letting
+     *  the capability default. */
+    build(userId: string): WorkforceSnapshot;
+}
+//# sourceMappingURL=workforce-snapshot.d.ts.map

package/packages/plugin-sdk/dist/workforce-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workforce-snapshot.d.ts","sourceRoot":"","sources":["../src/workforce-snapshot.ts"],"names":[],"mappings":"AAiBA;iEACiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB;0DACsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB;uCACmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB;oCACgC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;iCAEiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB;qEACiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B;;yDAEqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB;2CACuC;IACvC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;oBAGgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB;6DACyD;IACzD,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B;gCAC4B;IAC5B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC;;yCAEqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb;;qBAEiB;IACjB,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B;;+CAE2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB;iCAC6B;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;mDAE+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB;6CACyC;IACzC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B;;8BAE0B;IAC1B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB;oDACgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB;;sBAEkB;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;kCAO8B;IAC9B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAAC;CAC1C"}

package/packages/plugin-sdk/dist/workforce-snapshot.js

@@ -0,0 +1,18 @@
+// Capability shape for `host.workforceSnapshot` — used by the
+// Workforce Studio plugin to introspect + export the tenant's
+// agent configuration in one call.
+//
+// The host returns a complete read-only snapshot covering:
+//   - the main agent's identity (brand, default model) + the
+//     skills it actually sees (after scope/when filtering)
+//   - every active tool's schema, source plugin, and since
+//     version
+//   - every worker agent's prompt, allowed tools, allowed skills
+//
+// Unlike the catalog capabilities (host.toolCatalog,
+// host.skillCatalog) this surface includes the FULL skill body
+// so the studio's zip export can ship every skill .md file as
+// part of the bundle. The catalog capabilities stay slim for
+// the cases that only need names + descriptions.
+export {};
+//# sourceMappingURL=workforce-snapshot.js.map

package/packages/plugin-sdk/dist/workforce-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workforce-snapshot.js","sourceRoot":"","sources":["../src/workforce-snapshot.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,8DAA8D;AAC9D,mCAAmC;AACnC,EAAE;AACF,2DAA2D;AAC3D,6DAA6D;AAC7D,2DAA2D;AAC3D,2DAA2D;AAC3D,cAAc;AACd,iEAAiE;AACjE,EAAE;AACF,qDAAqD;AACrD,+DAA+D;AAC/D,8DAA8D;AAC9D,6DAA6D;AAC7D,iDAAiD"}

package/packages/server/builtinConfig/plugins/workforce-studio/manifest.json

@@ -0,0 +1,27 @@
+{
+  "id": "workforce-studio",
+  "version": "0.1.0",
+  "displayName": "Workforce Studio",
+  "description": "Inspect + export the tenant's main agent and every worker agent — system prompts, available tools, skills — into a single downloadable bundle. Phase 1 is read-only: editing + import land in later phases.",
+  "author": "tianshu-ai",
+  "license": "MIT",
+  "permissions": [],
+  "server": { "entry": "@tianshu-builtin/plugin-workforce-studio/server" },
+  "client": { "entry": "@tianshu-builtin/plugin-workforce-studio/client" },
+  "contributes": {
+    "adminPages": [
+      {
+        "id": "main",
+        "displayName": "Workforce Studio",
+        "icon": "Layers",
+        "component": "WorkforceStudioPage",
+        "group": "Tools",
+        "order": 50
+      }
+    ],
+    "apiRoutes": [
+      { "method": "GET", "path": "/snapshot", "handler": "getSnapshot" },
+      { "method": "GET", "path": "/snapshot/zip", "handler": "downloadZip" }
+    ]
+  }
+}