@linkshell/wire 0.2.30 → 0.2.32

package/dist/usage.js

@@ -4,18 +4,106 @@ export const usageQuerySchema = z.object({
     agent: z.string().min(1).max(128).default("all"),
 });
 export const usageTotalsSchema = z.object({
-    records: z.number(), sessions: z.number(), inputTokens: z.number(), outputTokens: z.number(),
-    cacheReadTokens: z.number(), cacheWriteTokens: z.number(), totalTokens: z.number(),
+    records: z.number(),
+    sessions: z.number(),
+    inputTokens: z.number(),
+    outputTokens: z.number(),
+    cacheReadTokens: z.number(),
+    cacheWriteTokens: z.number(),
+    totalTokens: z.number(),
+    estimatedCostUsd: z.number().nonnegative().optional(),
+});
+export const usageRemoteStatsSchema = z.object({
+    remoteTurns: z.number().int().nonnegative(),
+    remoteApprovals: z.number().int().nonnegative(),
 });
 export const usageReportSchema = z.object({
-    generatedAt: z.number(), days: z.number(), agent: z.string(), timezone: z.string(),
+    generatedAt: z.number(),
+    days: z.number(),
+    agent: z.string(),
+    timezone: z.string(),
     totals: usageTotalsSchema,
     daily: z.array(usageTotalsSchema.extend({ date: z.string() })),
     models: z.array(usageTotalsSchema.extend({ agent: z.string(), model: z.string() })),
     agents: z.array(z.object({
-        id: z.string(), label: z.string(), source: z.enum(["native", "acp"]),
-        status: z.enum(["available", "no_data"]), records: z.number(), totalTokens: z.number(), note: z.string(),
+        id: z.string(),
+        label: z.string(),
+        source: z.enum(["native", "acp"]),
+        status: z.enum(["available", "no_data"]),
+        records: z.number(),
+        totalTokens: z.number(),
+        note: z.string(),
+        estimatedCostUsd: z.number().nonnegative().optional(),
     })).optional(),
+    estimatedCostUsd: z.number().nonnegative().optional(),
+    remoteStats: usageRemoteStatsSchema.optional(),
     warnings: z.array(z.string()),
 });
+/**
+ * Reference public API pricing (USD per 1M tokens), ordered most-specific first.
+ * Subscription users (ChatGPT Plus/Pro, Claude Pro/Max) pay flat fees; this
+ * estimates the equivalent API value of work orchestrated through LinkShell.
+ */
+const MODEL_PRICING_RULES = [
+    // Anthropic Claude
+    { match: /claude[-_.]?opus[-_.]?(?:4[._][56]|5)/i, pricing: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 } },
+    { match: /opus/i, pricing: { input: 15, output: 75, cacheRead: 1.5, cacheWrite: 18.75 } },
+    { match: /sonnet/i, pricing: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 } },
+    { match: /claude[-_.]?haiku[-_.]?4[._]5/i, pricing: { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 } },
+    { match: /haiku/i, pricing: { input: 0.8, output: 4, cacheRead: 0.08, cacheWrite: 1 } },
+    // OpenAI / Codex
+    { match: /(?:gpt-5|o1|o3)[-_]pro/i, pricing: { input: 15, output: 60, cacheRead: 3.75, cacheWrite: 15 } },
+    { match: /gpt-5[-_.]?mini/i, pricing: { input: 0.25, output: 2, cacheRead: 0.025, cacheWrite: 0.25 } },
+    { match: /gpt-5[-_.]?nano/i, pricing: { input: 0.05, output: 0.4, cacheRead: 0.005, cacheWrite: 0.05 } },
+    { match: /codex[-_.]?mini/i, pricing: { input: 1.5, output: 6, cacheRead: 0.375, cacheWrite: 1.5 } },
+    { match: /gpt-5|codex/i, pricing: { input: 1.25, output: 10, cacheRead: 0.125, cacheWrite: 1.25 } },
+    { match: /gpt-4\.1[-_.]?mini/i, pricing: { input: 0.4, output: 1.6, cacheRead: 0.1, cacheWrite: 0.4 } },
+    { match: /gpt-4\.1[-_.]?nano/i, pricing: { input: 0.1, output: 0.4, cacheRead: 0.025, cacheWrite: 0.1 } },
+    { match: /gpt-4\.1/i, pricing: { input: 2, output: 8, cacheRead: 0.5, cacheWrite: 2 } },
+    { match: /gpt-4o[-_.]?mini/i, pricing: { input: 0.15, output: 0.6, cacheRead: 0.075, cacheWrite: 0.15 } },
+    { match: /gpt-4o/i, pricing: { input: 2.5, output: 10, cacheRead: 1.25, cacheWrite: 2.5 } },
+    { match: /o[34][-_.]?mini/i, pricing: { input: 1.1, output: 4.4, cacheRead: 0.275, cacheWrite: 1.1 } },
+    { match: /\bo3\b|\bo1\b/i, pricing: { input: 2, output: 8, cacheRead: 0.5, cacheWrite: 2 } },
+    // Google Gemini
+    { match: /gemini.*flash/i, pricing: { input: 0.3, output: 2.5, cacheRead: 0.075, cacheWrite: 0.3 } },
+    { match: /gemini/i, pricing: { input: 1.25, output: 10, cacheRead: 0.3125, cacheWrite: 1.25 } },
+    // xAI Grok & DeepSeek
+    { match: /grok/i, pricing: { input: 3, output: 15, cacheRead: 0.75, cacheWrite: 3 } },
+    { match: /deepseek/i, pricing: { input: 0.27, output: 1.1, cacheRead: 0.07, cacheWrite: 0.27 } },
+];
+const DEFAULT_PRICING_PER_MILLION = {
+    input: 2,
+    output: 8,
+    cacheRead: 0.2,
+    cacheWrite: 2,
+};
+export function modelPricingPerMillionUsd(model) {
+    const normalized = model.trim();
+    for (const rule of MODEL_PRICING_RULES) {
+        if (rule.match.test(normalized))
+            return rule.pricing;
+    }
+    return DEFAULT_PRICING_PER_MILLION;
+}
+function safeTokenCount(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+ * Pure reference cost estimator (in USD) for a model and non-overlapping token bucket totals.
+ */
+export function estimateModelCostUsd(model, totals) {
+    const input = safeTokenCount(totals.inputTokens);
+    const output = safeTokenCount(totals.outputTokens);
+    const cacheRead = safeTokenCount(totals.cacheReadTokens);
+    const cacheWrite = safeTokenCount(totals.cacheWriteTokens);
+    if (input === 0 && output === 0 && cacheRead === 0 && cacheWrite === 0)
+        return 0;
+    const rate = modelPricingPerMillionUsd(model);
+    const rawUsd = (input * rate.input +
+        output * rate.output +
+        cacheRead * rate.cacheRead +
+        cacheWrite * rate.cacheWrite) /
+        1_000_000;
+    return Math.round(rawUsd * 1_000_000) / 1_000_000;
+}
 //# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CACjD,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5F,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACnF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAClF,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACzG,CAAC,CAAC,CAAC,QAAQ,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;KACtD,CAAC,CAAC,CAAC,QAAQ,EAAE;IACd,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,WAAW,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC9C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC;AAqBH;;;;GAIG;AACH,MAAM,mBAAmB,GAAsE;IAC7F,mBAAmB;IACnB,EAAE,KAAK,EAAE,wCAAwC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IACxH,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;IACzF,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IACzF,EAAE,KAAK,EAAE,gCAAgC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAC/G,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE;IACvF,iBAAiB;IACjB,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE;IACzG,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IACtG,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IACxG,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE;IACpG,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IACnG,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE;IACvG,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE;IACzG,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE;IACvF,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IACzG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE;IAC3F,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE;IACtG,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE;IAC5F,gBAAgB;IAChB,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE;IACpG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;IAC/F,sBAAsB;IACtB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE;IACrF,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;CACjG,CAAC;AAEF,MAAM,2BAA2B,GAA2B;IAC1D,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,GAAG;IACd,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IACvD,CAAC;IACD,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,KAAyB;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,MAAsB;IACxE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjF,MAAM,IAAI,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GACV,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;QACjB,MAAM,GAAG,IAAI,CAAC,MAAM;QACpB,SAAS,GAAG,IAAI,CAAC,SAAS;QAC1B,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAC/B,SAAS,CAAC;IACZ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AACpD,CAAC"}

package/dist/watch.d.ts

@@ -31,8 +31,8 @@ export declare const watchConfigOptionSchema: z.ZodObject<{
     category: z.ZodDefault<z.ZodEnum<{
         model: "model";
         other: "other";
-        model_config: "model_config";
         mode: "mode";
+        model_config: "model_config";
         effort: "effort";
     }>>;
     current: z.ZodString;
@@ -49,10 +49,10 @@ export declare const watchActionSchema: z.ZodObject<{
     label: z.ZodString;
     role: z.ZodEnum<{
         choice: "choice";
+        always: "always";
         stop: "stop";
         reject: "reject";
         allow: "allow";
-        always: "always";
     }>;
     kind: z.ZodEnum<{
         permission: "permission";
@@ -126,8 +126,8 @@ export declare const watchSessionSchema: z.ZodObject<{
         category: z.ZodDefault<z.ZodEnum<{
             model: "model";
             other: "other";
-            model_config: "model_config";
             mode: "mode";
+            model_config: "model_config";
             effort: "effort";
         }>>;
         current: z.ZodString;
@@ -163,10 +163,10 @@ export declare const watchSessionSchema: z.ZodObject<{
         label: z.ZodString;
         role: z.ZodEnum<{
             choice: "choice";
+            always: "always";
             stop: "stop";
             reject: "reject";
             allow: "allow";
-            always: "always";
         }>;
         kind: z.ZodEnum<{
             permission: "permission";
@@ -292,8 +292,8 @@ export declare const watchSnapshotSchema: z.ZodObject<{
             category: z.ZodDefault<z.ZodEnum<{
                 model: "model";
                 other: "other";
-                model_config: "model_config";
                 mode: "mode";
+                model_config: "model_config";
                 effort: "effort";
             }>>;
             current: z.ZodString;
@@ -329,10 +329,10 @@ export declare const watchSnapshotSchema: z.ZodObject<{
             label: z.ZodString;
             role: z.ZodEnum<{
                 choice: "choice";
+                always: "always";
                 stop: "stop";
                 reject: "reject";
                 allow: "allow";
-                always: "always";
             }>;
             kind: z.ZodEnum<{
                 permission: "permission";
@@ -428,10 +428,10 @@ export declare const watchCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         label: z.ZodString;
         role: z.ZodEnum<{
             choice: "choice";
+            always: "always";
             stop: "stop";
             reject: "reject";
             allow: "allow";
-            always: "always";
         }>;
         kind: z.ZodEnum<{
             permission: "permission";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linkshell/wire",
-  "version": "0.2.30",
+  "version": "0.2.32",
   "description": "Wire protocol for LinkShell v2: session model, JSON-RPC methods, end-to-end encryption and the relay client.",
   "license": "MIT",
   "repository": {

package/src/direct.ts

@@ -11,6 +11,9 @@ export const DIRECT_LABEL = "linkshell-bulk";
 /** The most stream bytes in one message: every WebRTC stack takes this size. */
 export const DIRECT_CHUNK = 16 * 1024;
 
+/** Hard cap on decoded direct frames so a malformed frame cannot exhaust receiver memory. */
+export const DIRECT_MAX_FRAME_BYTES = 16 * 1024 * 1024;
+
 /**
  * STUN servers used when a host names none: they only tell each side its
  * public address. (Several, because none of them is reachable everywhere.)
@@ -41,7 +44,7 @@ export function encodeDirectFrame(frame: DirectFrame): Uint8Array {
 }
 
 export function decodeDirectFrame(bytes: Uint8Array): DirectFrame | undefined {
-  if (bytes.length < 5) return undefined;
+  if (bytes.length < 5 || bytes.length > DIRECT_MAX_FRAME_BYTES) return undefined;
   const stream = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(1);
   const payload = bytes.subarray(5);
   if (bytes[0] === DATA) return { type: "data", stream, data: payload };

package/src/index.ts

@@ -20,4 +20,5 @@ export * from "./watch.js";
 export * from "./usage.js";
 export * from "./side.js";
 export * from "./rpc-mcp.js";
+export * from "./lsa.js";
 export * from "./envelopes.js";

package/src/live-activity.ts

@@ -49,6 +49,41 @@ export const liveActivitySubscriptionSchema = z.object({
 });
 export type LiveActivitySubscription = z.infer<typeof liveActivitySubscriptionSchema>;
 
+export const liveActivityPlatformSchema = z.enum(["ios", "android"]);
+export type LiveActivityPlatform = z.infer<typeof liveActivityPlatformSchema>;
+
+/**
+ * Registers an iOS 17.2+ ActivityKit `pushToStartToken` (or Android background wakeup endpoint)
+ * so the host can start a Live Activity or wakeup alert even when the app was never opened first.
+ */
+export const liveActivityPushToStartSchema = z.object({
+  deviceId: z.string().min(1).max(256),
+  pushToStartToken: z.string().min(1).max(1024),
+  platform: liveActivityPlatformSchema,
+  serviceUrl: z.url().max(256),
+  grant: z.string().regex(/^[a-f0-9]{64}$/),
+  expiresAt: z.number().int().positive(),
+  computerKey: z.string().min(1).max(512),
+});
+export type LiveActivityPushToStart = z.infer<typeof liveActivityPushToStartSchema>;
+
+export const wakeupEventTypeSchema = z.enum(["approval", "question", "error", "completed"]);
+export type WakeupEventType = z.infer<typeof wakeupEventTypeSchema>;
+
+/**
+ * Zero-plaintext wakeup notice payload: carries only routing identifiers and transition kind,
+ * never source code, file paths, or prompt text, preserving end-to-end privacy.
+ */
+export const wakeupNoticeSchema = z.object({
+  machineId: z.string().min(1).max(256),
+  sessionId: z.string().min(1).max(256),
+  eventType: wakeupEventTypeSchema,
+  createdAt: z.number().int().positive(),
+});
+export type WakeupNotice = z.infer<typeof wakeupNoticeSchema>;
+export const liveActivityWakeupNoticeSchema = wakeupNoticeSchema;
+export type LiveActivityWakeupNotice = WakeupNotice;
+
 // ActivityKit accepts at most 4 KB. Preserve request identifiers exactly; drop
 // whole buttons when necessary, so a truncated choice can never be submitted.
 export function liveActivityContent(payload: LiveActivityPayload): LiveActivityContentState {

package/src/lsa.ts

@@ -0,0 +1,159 @@
+import { z } from "zod";
+
+/**
+ * LinkShell Agent (LSA) Phase 1 RPC contracts: deterministic task ledger,
+ * automated post-turn acceptance verification, memories, and due followups.
+ */
+
+export const lsaTaskStatusSchema = z.enum([
+  "queued",
+  "running",
+  "verifying",
+  "waiting_decision",
+  "completed",
+  "failed",
+  "cancelled",
+]);
+export type LsaTaskStatus = z.infer<typeof lsaTaskStatusSchema>;
+
+export const lsaDecisionSchema = z.enum(["accept", "retry", "cancel"]);
+export type LsaDecision = z.infer<typeof lsaDecisionSchema>;
+
+export const lsaTaskSchema = z.object({
+  id: z.string().min(1),
+  title: z.string().optional(),
+  goal: z.string().min(1),
+  status: lsaTaskStatusSchema,
+  cwd: z.string(),
+  worktree: z.boolean().optional(),
+  agent: z.string().optional(),
+  sessionId: z.string().optional(),
+  controllerEpoch: z.number().int().nonnegative().optional(),
+  acceptanceChecks: z.array(z.string()),
+  summary: z.string().optional(),
+  createdAt: z.number(),
+  updatedAt: z.number(),
+});
+export type LsaTask = z.infer<typeof lsaTaskSchema>;
+
+export const lsaMemorySchema = z.object({
+  id: z.string().optional(),
+  scope: z.string().optional(),
+  key: z.string().min(1),
+  content: z.string(),
+  tags: z.array(z.string()),
+  updatedAt: z.number(),
+});
+export type LsaMemory = z.infer<typeof lsaMemorySchema>;
+
+export const lsaFollowupSchema = z.object({
+  id: z.string().min(1),
+  taskId: z.string().optional(),
+  dueAt: z.number(),
+  note: z.string(),
+  done: z.boolean(),
+  triggeredAt: z.number().optional(),
+});
+export type LsaFollowup = z.infer<typeof lsaFollowupSchema>;
+
+export const lsaCandidateProjectSchema = z.object({
+  cwd: z.string(),
+  name: z.string(),
+  score: z.number(),
+  remote: z.string().optional(),
+  reason: z.string().optional(),
+});
+export type LsaCandidateProject = z.infer<typeof lsaCandidateProjectSchema>;
+
+export const lsaStatusSchema = z.object({
+  enabled: z.boolean(),
+  controllerEpoch: z.number().int().nonnegative(),
+  generation: z.number().int().positive(),
+  activeTasks: z.number().int().nonnegative(),
+  waitingDecisionTasks: z.number().int().nonnegative(),
+  dueFollowups: z.number().int().nonnegative(),
+  requiresYearlyTier: z.boolean(),
+  handoffSummary: z.string().optional(),
+  candidates: z.array(lsaCandidateProjectSchema).optional(),
+});
+export type LsaStatus = z.infer<typeof lsaStatusSchema>;
+
+export const lsaMethods = {
+  "lsa.status": {
+    params: z.object({
+      query: z.string().max(200).optional(),
+    }),
+    result: lsaStatusSchema,
+  },
+  "lsa.tasks": {
+    params: z.object({
+      taskId: z.string().optional(),
+      status: lsaTaskStatusSchema.optional(),
+      limit: z.number().int().positive().max(200).optional(),
+    }),
+    result: z.object({
+      tasks: z.array(lsaTaskSchema),
+    }),
+  },
+  "lsa.dispatch": {
+    params: z.object({
+      goal: z.string().min(1).max(20_000),
+      title: z.string().max(200).optional(),
+      cwd: z.string().optional(),
+      agent: z.string().optional(),
+      worktree: z.boolean().optional(),
+      acceptanceChecks: z.array(z.string().max(2000)).max(50).optional(),
+    }),
+    result: z.object({
+      task: lsaTaskSchema,
+    }),
+  },
+  "lsa.steer": {
+    params: z.object({
+      taskId: z.string().min(1),
+      instruction: z.string().min(1).max(20_000),
+      controllerEpoch: z.number().int().nonnegative().optional(),
+    }),
+    result: z.object({
+      task: lsaTaskSchema,
+    }),
+  },
+  "lsa.decide": {
+    params: z.object({
+      taskId: z.string().min(1),
+      decision: lsaDecisionSchema,
+      feedback: z.string().max(20_000).optional(),
+      controllerEpoch: z.number().int().nonnegative().optional(),
+    }),
+    result: z.object({
+      task: lsaTaskSchema,
+    }),
+  },
+  "lsa.memories": {
+    params: z.object({
+      op: z.enum(["list", "search", "save", "delete"]).optional(),
+      query: z.string().max(500).optional(),
+      scope: z.string().max(120).optional(),
+      key: z.string().max(200).optional(),
+      content: z.string().max(20_000).optional(),
+      tags: z.array(z.string().max(80)).max(32).optional(),
+      limit: z.number().int().positive().max(200).optional(),
+    }),
+    result: z.object({
+      memories: z.array(lsaMemorySchema),
+    }),
+  },
+  "lsa.followups": {
+    params: z.object({
+      op: z.enum(["list", "schedule", "complete", "delete"]).optional(),
+      id: z.string().optional(),
+      taskId: z.string().optional(),
+      dueAt: z.number().optional(),
+      note: z.string().max(2000).optional(),
+      includeDone: z.boolean().optional(),
+    }),
+    result: z.object({
+      followups: z.array(lsaFollowupSchema),
+    }),
+  },
+} as const;

package/src/model.ts

@@ -302,6 +302,10 @@ export const gitInfoSchema = z.object({
   head: z.string().optional(),
   /** Uncommitted changes in the working directory (a new worktree starts from the last commit, without them). */
   dirty: z.boolean(),
+  /** Normalized git origin remote (`host/owner/repo`), when configured. */
+  remote: z.string().optional(),
+  /** First commit hash of the repository, for cross-machine repo identity. */
+  rootCommit: z.string().optional(),
 });
 export type GitInfo = z.infer<typeof gitInfoSchema>;
 
@@ -356,6 +360,23 @@ export const machineInfoSchema = z.object({
 });
 export type MachineInfo = z.infer<typeof machineInfoSchema>;
 
+export const keepAwakeModeSchema = z.enum(["smart", "always", "off"]);
+export type KeepAwakeMode = z.infer<typeof keepAwakeModeSchema>;
+
+export const machinePowerSchema = z.object({
+  onBattery: z.boolean(),
+  percent: z.number().min(0).max(100).nullable(),
+  charging: z.boolean().optional(),
+});
+export type MachinePower = z.infer<typeof machinePowerSchema>;
+
+export const machineKeepAwakeSchema = z.object({
+  mode: keepAwakeModeSchema,
+  active: z.boolean(),
+  reason: z.string().optional(),
+});
+export type MachineKeepAwake = z.infer<typeof machineKeepAwakeSchema>;
+
 /** Whole-computer resource use; CPU is a delta across all logical cores, not load average. */
 export const machineMetricsSchema = z.object({
   sampledAt: z.number().nonnegative(),
@@ -382,6 +403,10 @@ export const machineMetricsSchema = z.object({
     /** Space available to this user; excludes filesystem reservations. */
     availableBytes: z.number().nonnegative(),
   }).optional(),
+  /** Battery and AC power state on laptops; absent on desktops or older hosts. */
+  power: machinePowerSchema.optional(),
+  /** Host idle-sleep assertion state; absent on older hosts. */
+  keepAwake: machineKeepAwakeSchema.optional(),
 });
 export type MachineMetrics = z.infer<typeof machineMetricsSchema>;
 

package/src/peer.ts

@@ -36,6 +36,7 @@ export type RequestHandler = (
   method: string,
   params: unknown,
   id: RpcId,
+  signal: AbortSignal,
 ) => unknown | Promise<unknown>;
 export type NotificationHandler = (method: string, params: unknown) => void;
 
@@ -62,6 +63,7 @@ interface Pending {
 export class RpcPeer {
   private nextId = 1;
   private readonly pending = new Map<RpcId, Pending>();
+  private readonly inbound = new Map<RpcId, AbortController>();
   private closed = false;
 
   constructor(private readonly options: RpcPeerOptions) {}
@@ -75,6 +77,7 @@ export class RpcPeer {
       if (limit > 0) {
         entry.timer = setTimeout(() => {
           this.pending.delete(id);
+          this.notify("$/cancelRequest", { id });
           reject(new RpcError(RPC_APP_ERROR, `请求超时（${method}，${limit} ms）`, { code: "timeout" }));
         }, limit);
       }
@@ -89,30 +92,42 @@ export class RpcPeer {
   }
 
   receive(text: string): void {
+    if (!text.includes("\n")) {
+      this.receiveLine(text);
+      return;
+    }
     for (const line of text.split("\n")) {
-      if (!line.trim()) continue;
-      let message: Record<string, unknown> | Record<string, unknown>[];
-      try {
-        message = JSON.parse(line) as typeof message;
-      } catch {
-        continue;
-      }
-      if (Array.isArray(message)) {
-        if (!message.length || message.length > 128) {
-          this.write({ jsonrpc: "2.0", id: null, error: { code: -32600, message: "invalid JSON-RPC batch" } });
-          continue;
-        }
-        const responses: Record<string, unknown>[] = [];
-        void Promise.all(message.map((entry) => Promise.resolve(this.dispatch(entry, (response) => { responses.push(response); }))))
-          .then(() => { if (responses.length) this.write(responses); });
-      } else void this.dispatch(message);
+      this.receiveLine(line);
+    }
+  }
+
+  private receiveLine(line: string): void {
+    if (!line || !line.trim()) return;
+    let message: Record<string, unknown> | Record<string, unknown>[];
+    try {
+      message = JSON.parse(line) as typeof message;
+    } catch {
+      return;
     }
+    if (Array.isArray(message)) {
+      if (!message.length || message.length > 128) {
+        this.write({ jsonrpc: "2.0", id: null, error: { code: -32600, message: "invalid JSON-RPC batch" } });
+        return;
+      }
+      const responses: Record<string, unknown>[] = [];
+      void Promise.all(message.map((entry) => Promise.resolve(this.dispatch(entry, (response) => { responses.push(response); }))))
+        .then(() => { if (responses.length) this.write(responses); });
+    } else void this.dispatch(message);
   }
 
   /** Rejects every in-flight request; later calls fail immediately. */
   close(reason = "连接已断开"): void {
     if (this.closed) return;
     this.closed = true;
+    for (const controller of this.inbound.values()) {
+      controller.abort();
+    }
+    this.inbound.clear();
     for (const [id, entry] of this.pending) {
       if (entry.timer) clearTimeout(entry.timer);
       entry.reject(new RpcError(RPC_APP_ERROR, `${reason} (${entry.method})`, { code: "closed" }));
@@ -147,6 +162,17 @@ export class RpcPeer {
     }
 
     if (id === undefined) {
+      if (method === "$/cancelRequest") {
+        const cancelId = (message.params as { id?: unknown } | null | undefined)?.id;
+        if (typeof cancelId === "string" || typeof cancelId === "number") {
+          const controller = this.inbound.get(cancelId);
+          if (controller) {
+            this.inbound.delete(cancelId);
+            controller.abort();
+          }
+        }
+        return;
+      }
       this.options.onNotification?.(method, message.params);
       return;
     }
@@ -156,14 +182,26 @@ export class RpcPeer {
       respond({ jsonrpc: "2.0", id, error: { code: RPC_METHOD_NOT_FOUND, message: `no handler for ${method}` } });
       return;
     }
+    const controller = new AbortController();
+    if (this.closed) {
+      controller.abort();
+      return;
+    }
+    this.inbound.set(id, controller);
+    const cleanup = () => {
+      if (this.inbound.get(id) === controller) this.inbound.delete(id);
+    };
     return Promise.resolve()
-      .then(() => handler(method, message.params, id))
+      .then(() => handler(method, message.params, id, controller.signal))
       .then(
         (result) => {
-          if (result === ABANDON) return;
+          cleanup();
+          if (result === ABANDON || controller.signal.aborted) return;
           respond({ jsonrpc: "2.0", id, result: result ?? {} });
         },
         (error: unknown) => {
+          cleanup();
+          if (controller.signal.aborted) return;
           const rpcError =
             error instanceof RpcError
               ? error