agentengine-sdk-python 0.8.4__py3-none-any.whl → 0.8.5__py3-none-any.whl

ksadk/plugins/providers/bundles/dsh-teams-client/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@kingsoftcloud/dsh-teams-client",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Teams client Cordis companion contribution",
+  "exports": {
+    ".": "./index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./client": "./client.js"
+  },
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml",
+    "client.js"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@kingsoftcloud/dsh-teams-leader-policy": "0.1.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@kingsoftcloud/dsh-app-studio"
+      ],
+      "platform": "web"
+    }
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-leader-policy/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-teams-leader-policy
+      name: '@kingsoftcloud/dsh-teams-leader-policy'

ksadk/plugins/providers/bundles/dsh-teams-leader-policy/index.mjs

@@ -0,0 +1,13 @@
+export const name = 'dsh-teams-leader-policy'
+export const inject = ["pluginCompanions", "teamsTools"]
+
+export async function apply(ctx) {
+  const dispose = await ctx.pluginCompanions.registerComponent('io.ksadk.teams', 'dsh-teams-leader-policy')
+  ctx.effect(() => dispose)
+  ctx.provide('teamsLeaderPolicy', Object.freeze({
+    pluginId: 'io.ksadk.teams', protocol: 'teams.ksadk.io/v1',
+    generationId: ctx.pluginCompanions.generationId,
+    executionPolicy: 'ksadk.execution-policy/v1',
+    authority: 'python-companion',
+  }))
+}

ksadk/plugins/providers/bundles/dsh-teams-leader-policy/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@kingsoftcloud/dsh-teams-leader-policy",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Teams leader-policy Cordis companion contribution",
+  "exports": {
+    ".": "./index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@kingsoftcloud/dsh-teams-tools": "0.1.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-profile/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-teams-profile
+      name: '@kingsoftcloud/dsh-teams-profile'

ksadk/plugins/providers/bundles/dsh-teams-profile/index.mjs

@@ -0,0 +1,12 @@
+export const name = 'dsh-teams-profile'
+export const inject = ["pluginCompanions"]
+
+export async function apply(ctx) {
+  const dispose = await ctx.pluginCompanions.registerComponent('io.ksadk.teams', 'dsh-teams-profile')
+  ctx.effect(() => dispose)
+  ctx.provide('teamsProfile', Object.freeze({
+    pluginId: 'io.ksadk.teams', protocol: 'teams.ksadk.io/v1',
+    generationId: ctx.pluginCompanions.generationId,
+    call: (operation, args, options) => ctx.pluginCompanions.call(operation, args, options),
+  }))
+}

ksadk/plugins/providers/bundles/dsh-teams-profile/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@kingsoftcloud/dsh-teams-profile",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Teams profile Cordis companion contribution",
+  "exports": {
+    ".": "./index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-router/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-teams-router
+      name: '@kingsoftcloud/dsh-teams-router'

ksadk/plugins/providers/bundles/dsh-teams-router/index.mjs

@@ -0,0 +1,16 @@
+export const name = 'dsh-teams-router'
+export const inject = ["pluginCompanions", "teamsTasks", "teamsProfile"]
+
+export async function apply(ctx) {
+  const dispose = await ctx.pluginCompanions.registerComponent('io.ksadk.teams', 'dsh-teams-router')
+  ctx.effect(() => dispose)
+  ctx.provide('teamsRouter', Object.freeze({
+    pluginId: 'io.ksadk.teams', protocol: 'teams.ksadk.io/v1',
+    generationId: ctx.pluginCompanions.generationId,
+    call(operation, args, options) {
+      return ctx.teamsTasks.operations.includes(operation)
+        ? ctx.teamsTasks.call(operation, args, options)
+        : ctx.teamsProfile.call(operation, args, options)
+    },
+  }))
+}

ksadk/plugins/providers/bundles/dsh-teams-router/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@kingsoftcloud/dsh-teams-router",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Teams router Cordis companion contribution",
+  "exports": {
+    ".": "./index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@kingsoftcloud/dsh-teams-tasks": "0.1.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-tasks/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-teams-tasks
+      name: '@kingsoftcloud/dsh-teams-tasks'

ksadk/plugins/providers/bundles/dsh-teams-tasks/index.mjs

@@ -0,0 +1,16 @@
+export const name = 'dsh-teams-tasks'
+export const inject = ["pluginCompanions", "teamsProfile"]
+
+export async function apply(ctx) {
+  const dispose = await ctx.pluginCompanions.registerComponent('io.ksadk.teams', 'dsh-teams-tasks')
+  ctx.effect(() => dispose)
+  ctx.provide('teamsTasks', Object.freeze({
+    pluginId: 'io.ksadk.teams', protocol: 'teams.ksadk.io/v1',
+    generationId: ctx.pluginCompanions.generationId,
+    operations: Object.freeze(['team_create_task', 'team_task_action', 'team_wait', 'team_submit_result']),
+    call(operation, args, options) {
+      if (!this.operations.includes(operation)) throw new Error('COMPANION_OPERATION_INVALID')
+      return ctx.teamsProfile.call(operation, args, options)
+    },
+  }))
+}

ksadk/plugins/providers/bundles/dsh-teams-tasks/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@kingsoftcloud/dsh-teams-tasks",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Teams tasks Cordis companion contribution",
+  "exports": {
+    ".": "./index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@kingsoftcloud/dsh-teams-profile": "0.1.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-tools/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-teams-tools
+      name: '@kingsoftcloud/dsh-teams-tools'

ksadk/plugins/providers/bundles/dsh-teams-tools/index.mjs

@@ -0,0 +1,25 @@
+import { readFile } from 'node:fs/promises'
+export const name = 'dsh-teams-tools'
+export const inject = ["pluginCompanions", "teamsRouter", "tools"]
+
+export async function apply(ctx) {
+  const dispose = await ctx.pluginCompanions.registerComponent('io.ksadk.teams', 'dsh-teams-tools')
+  ctx.effect(() => dispose)
+  ctx.provide('teamsTools', Object.freeze({
+    pluginId: 'io.ksadk.teams', protocol: 'teams.ksadk.io/v1',
+    generationId: ctx.pluginCompanions.generationId,
+  }))
+  const definitions = JSON.parse(await readFile(new URL('./tools.json', import.meta.url), 'utf8'))
+  for (const tool of definitions) {
+    ctx.effect(() => ctx.pluginCompanions.registerTool(tool.name, 'io.ksadk.teams', tool.name))
+    ctx.tools.register({
+      ...tool,
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+      },
+      isConcurrencySafe: () => tool.name === 'team_context',
+      execute: (args, execution) => ctx.teamsRouter.call(tool.name, args, { signal: execution.signal }),
+    })
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-tools/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@kingsoftcloud/dsh-teams-tools",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "Teams tools Cordis companion contribution",
+  "exports": {
+    ".": "./index.mjs",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "index.mjs",
+    "cordis.patch.yml",
+    "tools.json"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@kingsoftcloud/dsh-teams-router": "0.1.0",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}

ksadk/plugins/providers/bundles/dsh-teams-tools/tools.json

@@ -0,0 +1,235 @@
+[
+  {
+    "name": "team_context",
+    "description": "读取当前团队消息、成员和任务状态。",
+    "parameters": {
+      "type": "object",
+      "properties": {},
+      "required": [],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_message",
+    "description": "发布进度，或明确请求某成员执行；wake=false仅留言，不触发执行。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "content": {
+          "type": "string"
+        },
+        "targetMemberId": {
+          "type": "string"
+        },
+        "wake": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "content"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_create_task",
+    "description": "仅Leader：创建有验收标准的任务；指定负责人即自动派发，不要再额外wake。依赖用本轮已有taskId。",
+    "parameters": {
+      "additionalProperties": false,
+      "properties": {
+        "title": {
+          "maxLength": 200,
+          "minLength": 1,
+          "title": "Title",
+          "type": "string"
+        },
+        "description": {
+          "default": "",
+          "maxLength": 20000,
+          "title": "Description",
+          "type": "string"
+        },
+        "ownerMemberId": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Ownermemberid"
+        },
+        "dependencies": {
+          "items": {
+            "type": "string"
+          },
+          "maxItems": 64,
+          "title": "Dependencies",
+          "type": "array"
+        },
+        "acceptanceCriteria": {
+          "default": "提交可核验结果",
+          "maxLength": 5000,
+          "title": "Acceptancecriteria",
+          "type": "string"
+        },
+        "acceptancePolicy": {
+          "anyOf": [
+            {
+              "enum": [
+                "leader",
+                "human",
+                "result"
+              ],
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Acceptancepolicy"
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "title": "TaskCreateInput",
+      "type": "object"
+    }
+  },
+  {
+    "name": "team_wait",
+    "description": "仅Leader：持久等待一组任务验收/失败，不阻塞；调用后结束当前回复。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "taskIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "maxItems": 64
+        }
+      },
+      "required": [
+        "taskIds"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_task_action",
+    "description": "按最新 revision 领取任务；Leader 分配/重试，并仅在leader策略下审核任务结果。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "taskId": {
+          "type": "string"
+        },
+        "action": {
+          "enum": [
+            "assign",
+            "claim",
+            "retry",
+            "accept",
+            "reject"
+          ]
+        },
+        "expectedRevision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "ownerMemberId": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string",
+          "maxLength": 2000
+        }
+      },
+      "required": [
+        "taskId",
+        "action",
+        "expectedRevision"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_submit_result",
+    "description": "提交自己当前任务的可核验结果。成功Run结束及验收后才算成功。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "result": {
+          "type": "string"
+        },
+        "artifactIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_finish",
+    "description": "仅Leader：所有任务通过验收后提交最终成果，等待群主验收。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "result": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_publish_artifact",
+    "description": "登记当前独立工作区的实际交付文件，返回有来源和哈希的产物引用。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "path"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "team_read_artifact",
+    "description": "读取本群已显式共享的不可变交付物，复制到自己工作区并返回来源与摘要。",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "artifactId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "artifactId"
+      ],
+      "additionalProperties": false
+    }
+  }
+]

ksadk/plugins/providers/bundles/ksadk-codex/index.mjs

@@ -13,6 +13,6 @@ export const name = 'ksadk-codex-provider'
 export function apply(ctx) {
   // DSH owns package/Profile lifecycle. The fixed KsADK bridge retains the
   // existing Codex App Server backend and never executes package supplied argv.
-  ctx.provide('ksadkAgentProvider', contribution)
+  ctx.provide('ksadkCodexAgentProvider', contribution)
   ctx.effect(() => () => {})
 }

ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/index.mjs

@@ -109,6 +109,7 @@ function secureTokenEqual(actual, expected) {
 
 function parseScopedToken(presented, token, profileDigest, tools, allowExpired = false) {
   const parts = presented.split('.')
+  if (parts[0] === 'ks3') return parseCompanionToken(parts, token, profileDigest, tools, allowExpired)
   if (parts[0] === 'ks2') return parseResourceToken(parts, token, profileDigest, tools, allowExpired)
   if (parts.length !== 3 || parts[0] !== 'ks1') return null
   const [, payloadEncoded, signature] = parts
@@ -146,6 +147,33 @@ function parseScopedToken(presented, token, profileDigest, tools, allowExpired =
   return { root: false, scopeId: signature, aliases, expiresAt: payload.exp }
 }
 
+function parseCompanionToken(parts, token, profileDigest, tools, allowExpired) {
+  if (parts.length !== 3) return null
+  const [, encoded, signature] = parts
+  const expected = createHmac('sha256', token).update(`ks3.${encoded}`).digest('base64url')
+  if (!secureTokenEqual(signature, expected)) return null
+  let payload
+  try { payload = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8')) }
+  catch { return null }
+  if (!payload || payload.v !== 3 || payload.profileDigest !== profileDigest ||
+      !/^[A-Za-z0-9_.-]{1,128}$/.test(payload.pluginId) ||
+      !/^dshgen_[A-Za-z0-9_-]{24,96}$/.test(payload.generationId) ||
+      !/^[A-Za-z0-9_-]{32,256}$/.test(payload.handle) ||
+      !/^[A-Za-z0-9_.:-]{1,128}$/.test(payload.callId) ||
+      !/^[A-Za-z0-9_-]{16,64}$/.test(payload.jti) ||
+      !Number.isSafeInteger(payload.exp) ||
+      (!allowExpired && payload.exp <= Math.floor(Date.now() / 1000)) ||
+      payload.exp > Math.floor(Date.now() / 1000) + 120 ||
+      !payload.aliases || typeof payload.aliases !== 'object' || Array.isArray(payload.aliases) ||
+      Object.keys(payload.aliases).length !== 1) return null
+  const aliases = new Map(Object.entries(payload.aliases))
+  if ([...aliases].some(([alias, source]) => alias !== source ||
+      !tools.some(tool => tool.name === source))) return null
+  return { root: false, scopeId: signature, aliases, expiresAt: payload.exp,
+    companion: { pluginId: payload.pluginId, generationId: payload.generationId,
+      handle: payload.handle, callId: payload.callId } }
+}
+
 function parseResourceToken(parts, token, profileDigest, tools, allowExpired) {
   if (parts.length !== 3) return null
   const [, encoded, signature] = parts
@@ -456,6 +484,12 @@ export async function apply(ctx, config = {}) {
   let lastToolChange = Date.now()
   let tools = []
   let resourceBridge = null
+  let companionBridge = null
+  if (typeof ctx.inject === 'function') ctx.inject(['pluginCompanions'], companionCtx => {
+    const bridge = companionCtx.pluginCompanions
+    companionBridge = bridge
+    companionCtx.effect(() => () => { if (companionBridge === bridge) companionBridge = null })
+  })
   // A pending optional child does not add another Core or block ordinary tools.
   // Its dependency lifecycle clears the reference when the resource plugin stops.
   if (typeof ctx.inject === 'function') ctx.inject(['platformResources'], resourceCtx => {
@@ -713,6 +747,17 @@ export async function apply(ctx, config = {}) {
         result: toolFailure('Resource invocation context is required', 'RESOURCE_CONTEXT_REQUIRED') })
       return
     }
+    const companionOperation = companionBridge?.operationForTool(sourceToolName)
+    const companionScope = authorization.companion
+    if ((companionOperation || companionScope) &&
+        (!companionBridge || !companionScope || !companionOperation ||
+          companionScope.pluginId !== companionOperation.pluginId ||
+          companionScope.generationId !== companionBridge.generationId ||
+          companionScope.callId !== message.id)) {
+      writeJson(response, 200, { jsonrpc: '2.0', id: message.id,
+        result: toolFailure('Companion invocation context is required', 'COMPANION_CONTEXT_REQUIRED') })
+      return
+    }
     const argumentsValue = params.arguments ?? {}
     if (argumentsValue === null || typeof argumentsValue !== 'object' || Array.isArray(argumentsValue)) {
       writeJson(response, 200, jsonRpcError(message.id, -32602, 'tool arguments must be an object'))
@@ -746,9 +791,14 @@ export async function apply(ctx, config = {}) {
     const completion = Promise.resolve()
       .then(() => {
         const invoke = () => ctx.tools.execute({
-          callId: `mcp-${randomUUID()}`, name: sourceToolName,
+          callId: companionScope?.callId ?? `mcp-${randomUUID()}`, name: sourceToolName,
           arguments: argumentsValue, signal: controller.signal,
         })
+        if (companionScope) return companionBridge.withInvocation({
+          ...companionScope,
+          deadline: Math.min(Date.now() + callTimeoutMs, authorization.expiresAt * 1000),
+          signal: controller.signal,
+        }, invoke)
         return resourceScope ? resourceBridge.withInvocation({
           handle: resourceScope.handle,
           deadline: Math.min(Date.now() + callTimeoutMs, authorization.expiresAt * 1000),

ksadk/plugins/providers/bundles/ksadk-dsh-capability-host/package.json

@@ -16,12 +16,12 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.1"
   },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml",
-      "integrity": "sha256:70cf891711d9b6614a38a828d1196415ee9cc45ff43e933aa2105ddb3fa0e813"
+      "integrity": "sha256:c69f9d358c0aa4d16d91f39170b0ae42069a5c173d19924fe75d64c6f91e40c8"
     }
   }
 }