agentworkshop 0.2.1 → 0.3.0

package/sdk/lifecycle.mjs

@@ -0,0 +1,25 @@
+// ============================================================
+// AgentWorkShop SDK — 生命周期事件清单(宿主触发;单一事实源)
+// ============================================================
+
+/** 服务端生命周期事件清单(宿主触发;文档见 docs/plugins.md) */
+export const LIFECYCLE_EVENTS = Object.freeze([
+  'plugin:host:init',
+  'config:changed',
+  'event:*',
+  'daq:sample',
+  'dcw:write',
+  'line:start',
+  'line:stop',
+  'server:close',
+])
+
+/** 客户端生命周期事件清单 */
+export const CLIENT_EVENTS = Object.freeze([
+  'client:init',
+  'event:*',
+  'page:change',
+  'client:destroy',
+])
+
+export default { LIFECYCLE_EVENTS, CLIENT_EVENTS }

package/server/api/plugins/[name]/[...path].ts

@@ -0,0 +1,22 @@
+/**
+ * /api/plugins/:name/** —— 插件自注册 API 的转发层(exact-match)。
+ * 插件经 ctx.route(method, path, handler) 注册;handler(event) 返回值由 nitro 序列化。
+ * 鉴权由插件自行处理(v1 不强制;可经 resolveUser 复用业务鉴权)。
+ */
+import { defineEventHandler, createError, readBody } from 'h3'
+import { getPluginHost } from '@/server/services/workshop/plugins/host.mjs'
+
+export default defineEventHandler(async (event) => {
+  const host = getPluginHost()
+  if (!host) throw createError({ statusCode: 503, statusMessage: 'plugin host not ready' })
+  const name = String(event.context.params?.name ?? '')
+  const path = '/' + (event.context.params?.path ?? '').replace(/^\/+/, '')
+  const handler = host.routes.resolve(name, event.method, path)
+  if (!handler) {
+    throw createError({ statusCode: 404, statusMessage: `plugin route not found: ${event.method} /api/plugins/${name}${path}` })
+  }
+  // 预读 body 挂到 event(插件 handler 无 h3 导入能力,经 event.awBody 消费)
+  const awBody = await readBody(event).catch(() => undefined)
+  ;(event as Record<string, unknown>).awBody = awBody
+  return handler(event)
+})

package/server/api/plugins/client/[name].get.ts

@@ -0,0 +1,18 @@
+/**
+ * GET /api/plugins/client/:name —— 插件客户端脚本(text/javascript)。
+ * 自包含 ESM(无裸导入);客户端 loader 动态 import 后以 setup(ctx) 装载。
+ * 信任模型与 aw commands 相同:仅装载自己放入插件目录的可信代码。
+ */
+import { defineEventHandler, getRouterParam, setHeader, createError } from 'h3'
+import { readClientScript } from '@/server/services/workshop/plugins/host.mjs'
+
+export default defineEventHandler((event) => {
+  const name = String(getRouterParam(event, 'name') ?? '').replace(/\.mjs$/, '')
+  const r = readClientScript(name)
+  if (r.status !== 200) {
+    throw createError({ statusCode: r.status, statusMessage: r.status === 404 ? 'plugin client not found' : 'bad request' })
+  }
+  setHeader(event, 'content-type', r.contentType ?? 'text/javascript; charset=utf-8')
+  setHeader(event, 'cache-control', 'no-cache')
+  return r.code
+})

package/server/api/plugins/manifest.get.ts

@@ -0,0 +1,10 @@
+/**
+ * GET /api/plugins/manifest —— 已装载插件清单(免鉴权只读:名称/版本/作用域/路由/是否有客户端)。
+ * 客户端 loader 启动期拉取;未登录/服务未装载时返回空数组(前端静默)。
+ */
+import { pluginManifest } from '@/server/services/workshop/plugins/host.mjs'
+import { defineEventHandler } from 'h3'
+
+export default defineEventHandler(() => {
+  return { plugins: pluginManifest() }
+})

package/server/api/workshop/dcw/lines/[id]/start.post.ts

@@ -9,6 +9,7 @@ import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/d
 import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
 import { getActiveLineRun } from '@/server/services/workshop/dcw/line-run'
 import { recordOps } from '@/server/services/workshop/ops/ops'
+import { emitLineLifecycle } from '@/server/services/workshop/plugins/host.mjs'
 
 export default defineApiHandler(async (event) => {
   const user = resolveUser(event)
@@ -31,5 +32,6 @@ export default defineApiHandler(async (event) => {
     recipeId: active?.recipeId ?? String(body.recipeId ?? ''),
     detail: { runId: run.id, recipeId: body.recipeId ?? '' },
   })
+  emitLineLifecycle('line:start', { lineId: id, runId: run.id, recipeId: active?.recipeId ?? String(body.recipeId ?? ''), productName: active?.productName ?? '' })
   return { run, line: getDcwController().lineState(id) }
 })

package/server/api/workshop/dcw/lines/[id]/stop.post.ts

@@ -9,6 +9,7 @@ import { bindDcwBroadcast, getDcwController } from '@/server/services/workshop/d
 import { broadcastSceneEvent } from '@/server/services/workshop/scene-events'
 import { getActiveLineRun } from '@/server/services/workshop/dcw/line-run'
 import { recordOps } from '@/server/services/workshop/ops/ops'
+import { emitLineLifecycle } from '@/server/services/workshop/plugins/host.mjs'
 
 export default defineApiHandler(async (event) => {
   const user = resolveUser(event)
@@ -30,5 +31,6 @@ export default defineApiHandler(async (event) => {
     recipeId: active?.recipeId ?? '',
     detail: { runId: active?.runId ?? '' },
   })
+  emitLineLifecycle('line:stop', { lineId: id, runId: active?.runId ?? run?.id ?? '' })
   return { run, line: getDcwController().lineState(id) }
 })