@tbox.cn/app-template-agent 0.7.5 → 0.9.0

package/packages/module-weather/src/server/cards/weather/meta.ts

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-import type { CardMeta } from '@tbox.cn/app-contracts';
-
-export const dataSchema = z.object({
-  city: z.string(),
-  temp: z.number(),
-  weather: z.string(),
-  humidity: z.number(),
-});
-
-export type WeatherCardData = z.infer<typeof dataSchema>;
-
-const meta: CardMeta<typeof dataSchema> = {
-  cardType: 'weather',
-  dataSchema,
-  displayName: '天气卡片',
-  description: '展示某城市的天气数据，含温度、天气状况、湿度',
-  sampleData: {
-    city: '北京',
-    temp: 22,
-    weather: '晴',
-    humidity: 35,
-  },
-};
-
-export default meta;
-export { meta as weatherMeta };

package/packages/module-weather/src/server/index.ts

@@ -1,45 +0,0 @@
-import { weatherTool } from './tool';
-import weatherMeta from './cards/weather/meta';
-import { loadModuleSkills } from '@tbox.cn/app-sdk/server';
-import type { LocalSkill, ServerContext, ServerModule } from '@tbox.cn/app-sdk/server';
-import { weatherPreTool } from './pre-tools';
-
-export { weatherTool, weatherMeta };
-
-/** 卡片 meta 声明 map（key 约定 = meta.cardType；数据 + 类型源） */
-const cards = {
-  weather: weatherMeta,
-} as const;
-
-/**
- * 模块 skill 声明（009 模块文件化：SKILL.md 目录格式，文件即唯一源）。
- * - 底层能力：SDK `loadModuleSkills(packageName, import.meta.url)` 单策略定位包根
- *   （createRequire 包名解析：dev workspace link / 模块 dist / 应用 bundle dist / 发布态
- *   node_modules 全形态恒命中；失败 warn 可行动 + 恒 resolve []）；
- * - 顶层 await 加载 → 填回 serverModule.skills 声明式通道（装配端 registerAll 自动注册）；
- * - 前置：本包 exports 须含 "./package.json"（见 package.json）；
- * - 生成应用内（codegen 展开）调用名由 CLI 自动改写为 @app/<id>，源码按字面量包名写法。
- */
-const skills = Object.fromEntries(
-  (await loadModuleSkills('@app/module-weather', import.meta.url)).map((s) => [s.name, s]),
-) satisfies Record<string, LocalSkill>;
-
-/**
- * 模块前置工具声明（010：key 约定 = toolId，纯数据 + 一个 resolve 函数）。
- * 装配端 registerServerModules 自动注册（register 内无需代码）。
- */
-const preTools = {
-  getWeather: weatherPreTool,
-} as const;
-
-/** 模块注册入口：自注册闭环（与客户端 clientModule 对称） */
-export const serverModule = {
-  cards,
-  skills,
-  preTools,
-  declaration: { moduleId: 'weather' },
-  register(ctx: ServerContext): void {
-    ctx.tools.register(weatherTool);
-    ctx.cards.registerMap(cards);
-  },
-} satisfies ServerModule;

package/packages/module-weather/src/server/pre-tools.ts

@@ -1,20 +0,0 @@
-import { definePreTool } from '@tbox.cn/app-sdk/server';
-import { weatherTool } from './tool';
-
-/**
- * 前置工具声明（010）：getWeather 的 city 参数可工程化抽取（城市词表），
- * 无需模型抽参——词表命中即预执行，模型第一轮直接作答（省一轮 loop）。
- *
- * 演示形态：文本工程化抽取——决策即构造：
- *   抽到城市 → { decision: 'run', args: { city } }（预执行，args 强类型由 tool 推断）；
- *   抽不到 → { decision: 'skip' }（本轮不生效，模型正常调用工具）。
- */
-const CITIES = ['北京', '上海', '广州', '深圳', '杭州', '成都', '武汉', '西安', '南京', '重庆'];
-
-export const weatherPreTool = definePreTool(weatherTool, {
-  routing: { mode: 'keywords', terms: ['天气', '气温', '下雨', '下雪', '穿衣', '出行'] },
-  decide: ({ text }) => {
-    const city = CITIES.find((c) => text.includes(c));
-    return city ? { decision: 'run', args: { city } } : { decision: 'skip' };
-  },
-});

package/packages/module-weather/src/server/tool.ts

@@ -1,29 +0,0 @@
-import { createTool, withCardEmissionHint } from '@tbox.cn/app-sdk/server';
-import { z } from 'zod';
-
-/**
- * 天气查询工具 — 示例（v2 出卡协议：出参 cards 字段）
- * 顶层 = 答话事实（模型作答依据）；cards = 出卡声明（平台 capture 注入候选池并剥离 data，
- * 模型可见 descriptor {id, cardType, note}，正文末尾逐字引用当前 descriptor 的 id 决策出卡。
- * W2（2026-09-01）：withCardEmissionHint 预告知——description 注明「返回可展示卡片」。
- * W7：note = 主体+关键事实（城市/天气/温度），模型可据此转述要点。
- */
-export const weatherTool = withCardEmissionHint(
-  createTool({
-    id: 'getWeather',
-    description: '查询城市天气信息',
-    inputSchema: z.object({
-      city: z.string().describe('城市名称，如 北京、上海'),
-    }),
-    execute: async ({ city }) => {
-      const mockData: Record<string, { temp: number; weather: string; humidity: number }> = {
-        北京: { temp: 22, weather: '晴', humidity: 35 },
-        上海: { temp: 25, weather: '多云', humidity: 65 },
-        广州: { temp: 30, weather: '阵雨', humidity: 80 },
-        深圳: { temp: 29, weather: '多云', humidity: 75 },
-      };
-      const data = { city, ...(mockData[city] || { temp: 20, weather: '未知', humidity: 50 }) };
-      return { ...data, cards: [{ cardType: 'weather', data, note: `${city} ${data.weather} ${data.temp}℃` }] };
-    },
-  }),
-);

package/packages/module-weather/tbox.module.json

@@ -1,27 +0,0 @@
-{
-  "schemaVersion": 1,
-  "name": "module-weather",
-  "version": "0.1.0",
-  "kind": "business",
-  "risk": {
-    "level": "low",
-    "writeBoundary": "source"
-  },
-  "distribution": {
-    "defaultMode": "codegen"
-  },
-  "contributes": {
-    "handlers": [],
-    "tools": ["getWeather"],
-    "cards": [
-      { "cardType": "weather", "schemaVersion": 1 }
-    ],
-    "routes": [],
-    "pages": [],
-    "tabs": []
-  },
-  "dependencies": {
-    "modules": []
-  },
-  "env": []
-}

package/packages/module-weather/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "baseUrl": ".",
-    "jsx": "react-jsx",
-    "paths": {
-      "@tbox.cn/app-contracts": ["../contracts/src/index.ts"],
-      "@tbox.cn/app-contracts/*": ["../contracts/src/*"],
-      "@tbox.cn/app-sdk/server": ["../app-sdk/src/server/index.ts"],
-      "@tbox.cn/app-sdk/client": ["../app-sdk/src/client/index.ts"]
-    }
-  },
-  "include": ["src"]
-}