@agentdock/wire 0.0.70 → 0.0.72

package/dist/envelope.js

@@ -1 +1,77 @@
-"use strict";import{z as s}from"zod";import{isCuid as r}from"@paralleldrive/cuid2";import{createId as a}from"./utils.js";import{SessionEventSchema as u}from"./events.js";export const SessionRoleSchema=s.enum(["user","agent"]),SessionEnvelopeSchema=s.object({id:s.string(),time:s.number(),role:SessionRoleSchema,turn:s.string().optional(),subagent:s.string().refine(e=>r(e),{message:"subagent must be a cuid2 value"}).optional(),messageUuid:s.string().optional(),toolCallId:s.string().optional(),ev:u}).superRefine((e,o)=>{e.ev.t==="service"&&e.role!=="agent"&&o.addIssue({code:s.ZodIssueCode.custom,message:'service events must use role "agent"',path:["role"]}),(e.ev.t==="start"||e.ev.t==="stop")&&e.role!=="agent"&&o.addIssue({code:s.ZodIssueCode.custom,message:`${e.ev.t} events must use role "agent"`,path:["role"]}),(e.ev.t==="question"||e.ev.t==="permission-request")&&e.role!=="agent"&&o.addIssue({code:s.ZodIssueCode.custom,message:`${e.ev.t} events must use role "agent"`,path:["role"]}),e.ev.t==="answer"&&e.role!=="user"&&o.addIssue({code:s.ZodIssueCode.custom,message:'answer events must use role "user"',path:["role"]})});export function createEnvelope(e,o,t={}){return{id:t.id??a(),time:t.time??Date.now(),role:e,ev:o,...t.turn?{turn:t.turn}:{},...t.subagent?{subagent:t.subagent}:{},...t.messageUuid?{messageUuid:t.messageUuid}:{},...t.toolCallId?{toolCallId:t.toolCallId}:{}}}
+/**
+ * Session envelope schema.
+ *
+ * Wraps a SessionEvent with metadata (id, time, role, turn, subagent).
+ */
+import { z } from 'zod';
+import { isCuid } from '@paralleldrive/cuid2';
+import { createId } from './utils.js';
+import { SessionEventSchema } from './events.js';
+export const SessionRoleSchema = z.enum(['user', 'agent']);
+export const SessionEnvelopeSchema = z
+    .object({
+    id: z.string(),
+    time: z.number(),
+    role: SessionRoleSchema,
+    turn: z.string().optional(),
+    subagent: z
+        .string()
+        .refine((value) => isCuid(value), { message: 'subagent must be a cuid2 value' })
+        .optional(),
+    /** Claude CLI message UUID — used for precise conversation rollback. */
+    messageUuid: z.string().optional(),
+    /** Tool call ID — routes child events (e.g. bg-task:completed) to the parent card. */
+    toolCallId: z.string().optional(),
+    ev: SessionEventSchema,
+})
+    .superRefine((envelope, ctx) => {
+    if (envelope.ev.t === 'service' && envelope.role !== 'agent') {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'service events must use role "agent"',
+            path: ['role'],
+        });
+    }
+    if ((envelope.ev.t === 'start' || envelope.ev.t === 'stop') && envelope.role !== 'agent') {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${envelope.ev.t} events must use role "agent"`,
+            path: ['role'],
+        });
+    }
+    if ((envelope.ev.t === 'question' || envelope.ev.t === 'permission-request') &&
+        envelope.role !== 'agent') {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `${envelope.ev.t} events must use role "agent"`,
+            path: ['role'],
+        });
+    }
+    if (envelope.ev.t === 'answer' && envelope.role !== 'user') {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'answer events must use role "user"',
+            path: ['role'],
+        });
+    }
+});
+/**
+ * Create a SessionEnvelope by direct construction (hot path).
+ *
+ * Skips Zod `.parse()` for performance — the discriminated union with
+ * 14 variants + 4 superRefine checks is expensive on every streaming token.
+ * Validation still happens at ingress boundaries (server API handlers).
+ */
+export function createEnvelope(role, ev, opts = {}) {
+    return {
+        id: opts.id ?? createId(),
+        time: opts.time ?? Date.now(),
+        role,
+        ev,
+        ...(opts.turn ? { turn: opts.turn } : {}),
+        ...(opts.subagent ? { subagent: opts.subagent } : {}),
+        ...(opts.messageUuid ? { messageUuid: opts.messageUuid } : {}),
+        ...(opts.toolCallId ? { toolCallId: opts.toolCallId } : {}),
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"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"}

package/dist/errorMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMessage.d.ts","sourceRoot":"","sources":["../src/errorMessage.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGjD"}

package/dist/errorMessage.js

@@ -1 +1,6 @@
-"use strict";export function errorMessage(r){return r instanceof Error?r.message:String(r)}
+export function errorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=errorMessage.js.map

package/dist/errorMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorMessage.js","sourceRoot":"","sources":["../src/errorMessage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYjC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;EAO1C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;IAGxC,qDAAqD;;IAErD,mDAAmD;;;;;;;;;;;;EAEnD,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYjC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;EAEtC,CAAC;AAEH,eAAO,MAAM,0BAA0B,iDAA+C,CAAC;AACvF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,8CAA8C;AAC9C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAK1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;IAKpC,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;EAEzE,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;IAGlC,oEAAoE;;;;;;;;;;EAEpE,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;EAEjC,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB;;IAElC,iCAAiC;;IAEjC,+DAA+D;;;;;;;;;;EAE/D,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAjE7B,qDAAqD;;IAErD,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuCnD,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOzE,oEAAoE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWpE,iCAAiC;;IAEjC,+DAA+D;;;;;;;;;;IAmB/D,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG9D,OAAO,EACL,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,EACxB,oCAAoC,EACpC,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,6BAA6B,EAC7B,kBAAkB,EAClB,8BAA8B,EAC9B,gBAAgB,EAChB,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/events.js

@@ -1 +1,107 @@
-"use strict";import{z as e}from"zod";import{SessionQuestionEventSchema as t,SessionPermissionRequestEventSchema as n,SessionAnswerEventSchema as o,SessionPermissionResolvedEventSchema as s}from"./interactionEvents.js";export const SessionTextEventSchema=e.object({t:e.literal("text"),text:e.string(),thinking:e.boolean().optional(),images:e.array(e.object({data:e.string(),mediaType:e.string()})).optional()}),SessionServiceEventSchema=e.object({t:e.literal("service"),text:e.string()}),SessionToolCallStartEventSchema=e.object({t:e.literal("tool-call-start"),call:e.string(),name:e.string(),title:e.string(),description:e.string(),args:e.record(e.string(),e.unknown())}),SessionToolCallEndEventSchema=e.object({t:e.literal("tool-call-end"),call:e.string(),result:e.string().optional(),error:e.boolean().optional()}),SessionFileEventSchema=e.object({t:e.literal("file"),ref:e.string(),name:e.string(),size:e.number(),image:e.object({width:e.number(),height:e.number(),thumbhash:e.string()}).optional()}),SessionTurnStartEventSchema=e.object({t:e.literal("turn-start")}),SessionTurnEndStatusSchema=e.enum(["completed","failed","cancelled"]),TurnUsageSchema=e.object({inputTokens:e.number().int().nonnegative(),outputTokens:e.number().int().nonnegative(),cacheReadTokens:e.number().int().nonnegative().optional(),cacheWriteTokens:e.number().int().nonnegative().optional()}),SessionTurnEndEventSchema=e.object({t:e.literal("turn-end"),status:SessionTurnEndStatusSchema,usage:TurnUsageSchema.optional(),model:e.string().optional(),durationMs:e.number().int().nonnegative().optional()}),SessionStartEventSchema=e.object({t:e.literal("start"),title:e.string().optional(),taskId:e.string().optional()}),SessionStopEventSchema=e.object({t:e.literal("stop")}),SessionImageEventSchema=e.object({t:e.literal("image"),data:e.string(),mediaType:e.string()}),SessionEventSchema=e.discriminatedUnion("t",[SessionTextEventSchema,SessionServiceEventSchema,SessionToolCallStartEventSchema,SessionToolCallEndEventSchema,SessionFileEventSchema,SessionTurnStartEventSchema,SessionTurnEndEventSchema,SessionStartEventSchema,SessionStopEventSchema,t,n,o,s,SessionImageEventSchema]);export{SessionQuestionEventSchema,SessionPermissionRequestEventSchema,SessionAnswerEventSchema,SessionPermissionResolvedEventSchema,PermissionActionSchema,ImageAttachmentSchema}from"./interactionEvents.js";
+/**
+ * Session event schemas.
+ *
+ * Event types: text, service, tool-call-start, tool-call-end,
+ * file, turn-start, turn-end, start, stop.
+ */
+import { z } from 'zod';
+import { SessionQuestionEventSchema, SessionPermissionRequestEventSchema, SessionAnswerEventSchema, SessionPermissionResolvedEventSchema, } from './interactionEvents.js';
+export const SessionTextEventSchema = z.object({
+    t: z.literal('text'),
+    text: z.string(),
+    thinking: z.boolean().optional(),
+    images: z
+        .array(z.object({
+        data: z.string(),
+        mediaType: z.string(),
+    }))
+        .optional(),
+});
+export const SessionServiceEventSchema = z.object({
+    t: z.literal('service'),
+    text: z.string(),
+});
+export const SessionToolCallStartEventSchema = z.object({
+    t: z.literal('tool-call-start'),
+    call: z.string(),
+    name: z.string(),
+    title: z.string(),
+    description: z.string(),
+    args: z.record(z.string(), z.unknown()),
+});
+export const SessionToolCallEndEventSchema = z.object({
+    t: z.literal('tool-call-end'),
+    call: z.string(),
+    /** Tool output text (may be truncated at source). */
+    result: z.string().optional(),
+    /** True when the tool returned an error result. */
+    error: z.boolean().optional(),
+});
+export const SessionFileEventSchema = z.object({
+    t: z.literal('file'),
+    ref: z.string(),
+    name: z.string(),
+    size: z.number(),
+    image: z
+        .object({
+        width: z.number(),
+        height: z.number(),
+        thumbhash: z.string(),
+    })
+        .optional(),
+});
+export const SessionTurnStartEventSchema = z.object({
+    t: z.literal('turn-start'),
+});
+export const SessionTurnEndStatusSchema = z.enum(['completed', 'failed', 'cancelled']);
+/** Token usage stats reported at turn end. */
+export const TurnUsageSchema = z.object({
+    inputTokens: z.number().int().nonnegative(),
+    outputTokens: z.number().int().nonnegative(),
+    cacheReadTokens: z.number().int().nonnegative().optional(),
+    cacheWriteTokens: z.number().int().nonnegative().optional(),
+});
+export const SessionTurnEndEventSchema = z.object({
+    t: z.literal('turn-end'),
+    status: SessionTurnEndStatusSchema,
+    usage: TurnUsageSchema.optional(),
+    model: z.string().optional(),
+    /** Wall-clock duration of the turn in milliseconds (Date.now() diff). */
+    durationMs: z.number().int().nonnegative().optional(),
+});
+export const SessionStartEventSchema = z.object({
+    t: z.literal('start'),
+    title: z.string().optional(),
+    /** Claude background task ID for cancellation (RFC-058 Phase 2). */
+    taskId: z.string().optional(),
+});
+export const SessionStopEventSchema = z.object({
+    t: z.literal('stop'),
+});
+/** User-sent image stored inline in envelope (base64). */
+export const SessionImageEventSchema = z.object({
+    t: z.literal('image'),
+    /** Base64-encoded image data. */
+    data: z.string(),
+    /** MIME type: image/jpeg, image/png, image/gif, image/webp. */
+    mediaType: z.string(),
+});
+export const SessionEventSchema = z.discriminatedUnion('t', [
+    SessionTextEventSchema,
+    SessionServiceEventSchema,
+    SessionToolCallStartEventSchema,
+    SessionToolCallEndEventSchema,
+    SessionFileEventSchema,
+    SessionTurnStartEventSchema,
+    SessionTurnEndEventSchema,
+    SessionStartEventSchema,
+    SessionStopEventSchema,
+    SessionQuestionEventSchema,
+    SessionPermissionRequestEventSchema,
+    SessionAnswerEventSchema,
+    SessionPermissionResolvedEventSchema,
+    SessionImageEventSchema,
+]);
+// Re-export interaction event schemas for convenience
+export { SessionQuestionEventSchema, SessionPermissionRequestEventSchema, SessionAnswerEventSchema, SessionPermissionResolvedEventSchema, PermissionActionSchema, ImageAttachmentSchema, } from './interactionEvents.js';
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AASA,sFAAsF;AACtF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxD;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,iBAAiB,EAiD/C,CAAC;AAEX;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,OAAO,CAKT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAYT;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAGpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,aAAa,CAAC,EAAE,MAAM,GACrB,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAAE,CAkBjD"}

package/dist/features.js

@@ -1 +1,123 @@
-"use strict";import{satisfiesMin as u}from"./semver.js";export const FEATURE_REGISTRY=[{id:"agent-settings",requiredMethods:["get-agent-settings","set-agent-settings"],sinceVersion:"0.0.4",subFeatures:[{id:"startup-scripts",sinceVersion:"0.0.30"}]},{id:"labs-settings",requiredMethods:["get-labs-settings","set-labs-settings"],sinceVersion:"0.0.12"},{id:"history-sync",requiredMethods:["backfill-history-session"],sinceVersion:"0.0.12"},{id:"check-path",requiredMethods:["check-path"],sinceVersion:"0.0.7"},{id:"remote-upgrade",requiredMethods:["trigger-upgrade"],sinceVersion:"0.0.30"},{id:"checkpoint",requiredMethods:["checkpoint-list","checkpoint-diff","checkpoint-rollback"],sinceVersion:"0.0.30",subFeatures:[{id:"conversation-rollback",sinceVersion:"0.0.32"}]},{id:"scheduled-tasks",requiredMethods:["spawn-session"],sinceVersion:"0.0.35"},{id:"auto-upgrade-daemon",requiredMethods:["set-auto-upgrade-daemon"],sinceVersion:"0.0.31"},{id:"file-upload",requiredMethods:["file-relay-receive"],sinceVersion:"0.0.36",edition:"personal"}];export function isFeatureAvailable(r,n){const t=FEATURE_REGISTRY.find(e=>e.id===r);if(!t)return!1;const i=new Set(n);return t.requiredMethods.every(e=>i.has(e))}export function isSubFeatureAvailable(r,n,t,i){const e=FEATURE_REGISTRY.find(o=>o.id===r);if(!e||!isFeatureAvailable(r,t))return!1;const s=e.subFeatures?.find(o=>o.id===n);if(!s||!i||!u(i,s.sinceVersion))return!1;if(s.requiredMethods){const o=new Set(t);return s.requiredMethods.every(d=>o.has(d))}return!0}export function getSubFeatureMinVersion(r,n){return FEATURE_REGISTRY.find(i=>i.id===r)?.subFeatures?.find(i=>i.id===n)?.sinceVersion}export function getUnavailableFeatures(r,n){const t=[],i=new Set(r);for(const e of FEATURE_REGISTRY)if(!e.requiredMethods.every(s=>i.has(s)))t.push({id:e.id,sinceVersion:e.sinceVersion});else if(e.subFeatures&&n)for(const s of e.subFeatures){const o=!u(n,s.sinceVersion),d=s.requiredMethods!=null&&!s.requiredMethods.every(c=>i.has(c));(o||d)&&t.push({id:`${e.id}/${s.id}`,sinceVersion:s.sinceVersion})}return t}
+/* Feature availability layer (RFC-035).
+ *
+ * Maps high-level features to the RPC methods they require.
+ * Used by web to determine which features a daemon supports
+ * based on the methods it has registered.
+ */
+import { satisfiesMin } from './semver.js';
+/**
+ * Registry of all known features and their RPC dependencies.
+ * Add new entries here when introducing features that require new daemon RPC methods.
+ */
+export const FEATURE_REGISTRY = [
+    {
+        id: 'agent-settings',
+        requiredMethods: ['get-agent-settings', 'set-agent-settings'],
+        sinceVersion: '0.0.4',
+        subFeatures: [{ id: 'startup-scripts', sinceVersion: '0.0.30' }],
+    },
+    {
+        id: 'labs-settings',
+        requiredMethods: ['get-labs-settings', 'set-labs-settings'],
+        sinceVersion: '0.0.12',
+    },
+    {
+        id: 'history-sync',
+        requiredMethods: ['backfill-history-session'],
+        sinceVersion: '0.0.12',
+    },
+    {
+        id: 'check-path',
+        requiredMethods: ['check-path'],
+        sinceVersion: '0.0.7',
+    },
+    {
+        id: 'remote-upgrade',
+        requiredMethods: ['trigger-upgrade'],
+        sinceVersion: '0.0.30',
+    },
+    {
+        id: 'checkpoint',
+        requiredMethods: ['checkpoint-list', 'checkpoint-diff', 'checkpoint-rollback'],
+        sinceVersion: '0.0.30',
+        subFeatures: [{ id: 'conversation-rollback', sinceVersion: '0.0.32' }],
+    },
+    {
+        id: 'scheduled-tasks',
+        requiredMethods: ['spawn-session'],
+        sinceVersion: '0.0.35',
+    },
+    {
+        id: 'auto-upgrade-daemon',
+        requiredMethods: ['set-auto-upgrade-daemon'],
+        sinceVersion: '0.0.31',
+    },
+    {
+        id: 'file-upload',
+        requiredMethods: ['file-relay-receive'],
+        sinceVersion: '0.0.36',
+        edition: 'personal',
+    },
+];
+/**
+ * Check whether a specific feature is available given the set of supported methods.
+ * A feature is available when ALL its required methods are present.
+ */
+export function isFeatureAvailable(featureId, supportedMethods) {
+    const feature = FEATURE_REGISTRY.find((f) => f.id === featureId);
+    if (!feature)
+        return false;
+    const methodSet = new Set(supportedMethods);
+    return feature.requiredMethods.every((m) => methodSet.has(m));
+}
+/**
+ * Check whether a sub-feature is available given supported methods and daemon version.
+ * Requires the parent feature to be available AND the daemon version to satisfy the sub-feature minimum.
+ */
+export function isSubFeatureAvailable(featureId, subFeatureId, supportedMethods, daemonVersion) {
+    const feature = FEATURE_REGISTRY.find((f) => f.id === featureId);
+    if (!feature)
+        return false;
+    if (!isFeatureAvailable(featureId, supportedMethods))
+        return false;
+    const sub = feature.subFeatures?.find((s) => s.id === subFeatureId);
+    if (!sub)
+        return false;
+    if (!daemonVersion || !satisfiesMin(daemonVersion, sub.sinceVersion))
+        return false;
+    if (sub.requiredMethods) {
+        const methodSet = new Set(supportedMethods);
+        return sub.requiredMethods.every((m) => methodSet.has(m));
+    }
+    return true;
+}
+/** Look up the minimum version required for a sub-feature. */
+export function getSubFeatureMinVersion(featureId, subFeatureId) {
+    const feature = FEATURE_REGISTRY.find((f) => f.id === featureId);
+    return feature?.subFeatures?.find((s) => s.id === subFeatureId)?.sinceVersion;
+}
+/**
+ * Return all features (and sub-features) that are NOT available.
+ * Sub-features are returned as "parentId/subId" when the parent is available
+ * but the daemon version is too low for the sub-feature.
+ */
+export function getUnavailableFeatures(supportedMethods, daemonVersion) {
+    const results = [];
+    const methodSet = new Set(supportedMethods);
+    for (const f of FEATURE_REGISTRY) {
+        if (!f.requiredMethods.every((m) => methodSet.has(m))) {
+            results.push({ id: f.id, sinceVersion: f.sinceVersion });
+        }
+        else if (f.subFeatures && daemonVersion) {
+            for (const sub of f.subFeatures) {
+                const versionLocked = !satisfiesMin(daemonVersion, sub.sinceVersion);
+                const methodsLocked = sub.requiredMethods != null && !sub.requiredMethods.every((m) => methodSet.has(m));
+                if (versionLocked || methodsLocked) {
+                    results.push({ id: `${f.id}/${sub.id}`, sinceVersion: sub.sinceVersion });
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=features.js.map

package/dist/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"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"}

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,wCAAsC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,oBAAoB,2CAAyC,CAAC;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,aAAa,4EAMxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc,gGAAgC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAK1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;IAQjC,6FAA6F;;;;;;;;;;;;;;;;;;;;;;EAI7F,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAnB3B,6FAA6F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB7F,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA1B/B,6FAA6F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC7F,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/feedback.js

@@ -1 +1,61 @@
-"use strict";import{z as o}from"zod";export const FeedbackTypeSchema=o.enum(["BUG","FEATURE","OTHER"]),FeedbackStatusSchema=o.enum(["UNREAD","READ","ARCHIVED"]),RunModeSchema=o.enum(["web-session","cli-spawn","cli-run","scheduled","unknown"]),RunModesSchema=o.array(RunModeSchema).max(5),BugFieldsSchema=o.object({reproSteps:o.string().max(2e3).optional(),expectedBehavior:o.string().max(1e3).optional(),actualBehavior:o.string().max(1e3).optional(),errorMessages:o.string().max(2e3).optional()}),SettingsSnapshotSchema=o.object({browser:o.object({userAgent:o.string(),viewport:o.string(),language:o.string()}).optional(),machines:o.record(o.string(),o.record(o.unknown())).optional(),preferences:o.record(o.unknown()).optional(),labs:o.record(o.unknown()).optional()}),MachineSnapshotSchema=o.object({machineId:o.string(),platform:o.string().optional(),arch:o.string().optional(),hostname:o.string().optional(),daemonVersion:o.string().optional(),availableAgents:o.array(o.string()).optional(),agentVersions:o.record(o.string()).optional(),nodeVersion:o.string().optional()}),DeviceInfoSchema=o.object({machines:o.array(MachineSnapshotSchema).optional(),appVersion:o.string().optional(),settingsSnapshot:SettingsSnapshotSchema.optional()}),CreateFeedbackSchema=o.object({type:FeedbackTypeSchema,description:o.string().min(0).max(5e3),screenshots:o.array(o.string().max(7e5)).max(3).optional(),deviceInfo:DeviceInfoSchema,affectedMachineIds:o.array(o.string()).max(20).optional(),affectedAgents:o.array(o.string()).max(10).optional(),runModes:RunModesSchema.optional(),bugFields:BugFieldsSchema.optional()}),UpdateFeedbackSchema=o.object({status:o.enum(["READ","ARCHIVED"]).optional(),reply:o.string().min(1).max(5e3).optional()});
+// KNOWN-DEBT: feedback 模块导出类型零消费 + web 侧重复定义 (see docs/ops/KNOWN-DEBT.md)
+import { z } from 'zod';
+export const FeedbackTypeSchema = z.enum(['BUG', 'FEATURE', 'OTHER']);
+export const FeedbackStatusSchema = z.enum(['UNREAD', 'READ', 'ARCHIVED']);
+export const RunModeSchema = z.enum([
+    'web-session',
+    'cli-spawn',
+    'cli-run',
+    'scheduled',
+    'unknown',
+]);
+export const RunModesSchema = z.array(RunModeSchema).max(5);
+export const BugFieldsSchema = z.object({
+    reproSteps: z.string().max(2000).optional(),
+    expectedBehavior: z.string().max(1000).optional(),
+    actualBehavior: z.string().max(1000).optional(),
+    errorMessages: z.string().max(2000).optional(),
+});
+export const SettingsSnapshotSchema = z.object({
+    browser: z
+        .object({
+        userAgent: z.string(),
+        viewport: z.string(),
+        language: z.string(),
+    })
+        .optional(),
+    /** Per-machine diagnostics: platform, arch, daemonVersion, availableAgents, agentCliPaths */
+    machines: z.record(z.string(), z.record(z.unknown())).optional(),
+    preferences: z.record(z.unknown()).optional(),
+    labs: z.record(z.unknown()).optional(),
+});
+export const MachineSnapshotSchema = z.object({
+    machineId: z.string(),
+    platform: z.string().optional(),
+    arch: z.string().optional(),
+    hostname: z.string().optional(),
+    daemonVersion: z.string().optional(),
+    availableAgents: z.array(z.string()).optional(),
+    agentVersions: z.record(z.string()).optional(),
+    nodeVersion: z.string().optional(),
+});
+export const DeviceInfoSchema = z.object({
+    machines: z.array(MachineSnapshotSchema).optional(),
+    appVersion: z.string().optional(),
+    settingsSnapshot: SettingsSnapshotSchema.optional(),
+});
+export const CreateFeedbackSchema = z.object({
+    type: FeedbackTypeSchema,
+    description: z.string().min(0).max(5000),
+    screenshots: z.array(z.string().max(700_000)).max(3).optional(),
+    deviceInfo: DeviceInfoSchema,
+    affectedMachineIds: z.array(z.string()).max(20).optional(),
+    affectedAgents: z.array(z.string()).max(10).optional(),
+    runModes: RunModesSchema.optional(),
+    bugFields: BugFieldsSchema.optional(),
+});
+export const UpdateFeedbackSchema = z.object({
+    status: z.enum(['READ', 'ARCHIVED']).optional(),
+    reply: z.string().min(1).max(5000).optional(),
+});
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"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"}

package/dist/fileWhitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWhitelist.d.ts","sourceRoot":"","sources":["../src/fileWhitelist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAYlE,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAWtC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAgBtC,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAQrC,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAQrC,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAKzE,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAS3C,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAKjD,CAAC;AASH;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CACpC,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAexE,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAMpE;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAqBvE"}

package/dist/fileWhitelist.js

@@ -1 +1,189 @@
-"use strict";const i=["text","document","code","image"];export const TEXT_EXTS=[".txt",".md",".log",".csv",".json",".xml",".yaml",".yml",".toml",".env"],CODE_EXTS=[".ts",".tsx",".js",".jsx",".py",".rs",".go",".java",".c",".cpp",".h",".css",".html",".sql",".sh"],DOC_EXTS=[".pdf",".doc",".docx",".xls",".xlsx",".ppt",".pptx"],IMG_EXTS=[".png",".jpg",".jpeg",".gif",".webp",".svg",".bmp"],FILE_CATEGORY_MAX_SIZE={text:1048576,document:2097152,code:1048576,image:1048576},BLOCKED_EXTS=new Set([".exe",".bat",".cmd",".msi",".dmg",".app",".com",".scr"]),ALLOWED_EXTENSIONS=new Set([...TEXT_EXTS,...CODE_EXTS,...DOC_EXTS,...IMG_EXTS]);const o={text:TEXT_EXTS,code:CODE_EXTS,document:DOC_EXTS,image:IMG_EXTS};export const FILE_SIGNATURES={".pdf":{sig:[37,80,68,70,45]},".doc":{sig:[208,207,17,224,161,177,26,225]},".xls":{sig:[208,207,17,224,161,177,26,225]},".ppt":{sig:[208,207,17,224,161,177,26,225]},".docx":{sig:[80,75,3,4]},".xlsx":{sig:[80,75,3,4]},".pptx":{sig:[80,75,3,4]},".png":{sig:[137,80,78,71,13,10,26,10]},".jpg":{sig:[255,216,255]},".jpeg":{sig:[255,216,255]},".gif":{sig:[71,73,70,56]},".webp":{sig:[82,73,70,70],subSigAt:8,subSig:[87,69,66,80]},".bmp":{sig:[66,77]}};export function getFileExt(t){const x=t.lastIndexOf(".");return x>=0?t.substring(x).toLowerCase():""}export function resolveFileCategory(t){if(t===""||BLOCKED_EXTS.has(t))return null;for(const x of i)if(o[x].includes(t))return x;return null}function r(t){try{return new TextDecoder("utf-8",{fatal:!0}).decode(t)}catch{return null}}function g(t){const x=r(t.subarray(0,Math.min(t.length,512)));if(x===null)return!1;const e=(x.charCodeAt(0)===65279?x.slice(1):x).trimStart();return e.startsWith("<?xml")||e.startsWith("<svg")||e.startsWith("<!DOCTYPE svg")}export function verifyMagicBytes(t,x){if(TEXT_EXTS.includes(x)||CODE_EXTS.includes(x))return r(t)!==null;if(x===".svg")return g(t);const e=FILE_SIGNATURES[x];if(!e||t.length<e.sig.length)return!1;for(let s=0;s<e.sig.length;s++)if(t[s]!==e.sig[s])return!1;if(e.subSig){const s=e.subSigAt??e.sig.length;if(t.length<s+e.subSig.length)return!1;for(let n=0;n<e.subSig.length;n++)if(t[s+n]!==e.subSig[n])return!1}return!0}
+/**
+ * File upload whitelist — single source of truth for personal-edition file
+ * upload validation, shared across web (PWA client), server (relay preflight),
+ * and daemon (receiver second-check).
+ *
+ * Contains ONLY isomorphic data + pure byte logic (no node:/DOM deps):
+ *   - per-category extension lists and max sizes
+ *   - blocked (executable) extensions
+ *   - magic-byte signatures
+ *   - category resolution + magic-byte verification over Uint8Array
+ *
+ * File reading differs per platform (File/FileReader on web, Buffer on
+ * server/daemon), so callers read the head bytes themselves and pass a
+ * Uint8Array in. Buffer is a Uint8Array subclass, so `verifyMagicBytes`
+ * works unchanged on both.
+ */
+/** All file categories in priority order (first match wins in resolveFileCategory). */
+const FILE_CATEGORIES = ['text', 'document', 'code', 'image'];
+export const TEXT_EXTS = [
+    '.txt',
+    '.md',
+    '.log',
+    '.csv',
+    '.json',
+    '.xml',
+    '.yaml',
+    '.yml',
+    '.toml',
+    '.env',
+];
+export const CODE_EXTS = [
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.py',
+    '.rs',
+    '.go',
+    '.java',
+    '.c',
+    '.cpp',
+    '.h',
+    '.css',
+    '.html',
+    '.sql',
+    '.sh',
+];
+export const DOC_EXTS = [
+    '.pdf',
+    '.doc',
+    '.docx',
+    '.xls',
+    '.xlsx',
+    '.ppt',
+    '.pptx',
+];
+export const IMG_EXTS = [
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.svg',
+    '.bmp',
+];
+/** Per-category max upload size in bytes. */
+export const FILE_CATEGORY_MAX_SIZE = {
+    text: 1 * 1024 * 1024, // 1 MB
+    document: 2 * 1024 * 1024, // 2 MB
+    code: 1 * 1024 * 1024, // 1 MB
+    image: 1 * 1024 * 1024, // 1 MB
+};
+/** Executable / dangerous extensions — always rejected. */
+export const BLOCKED_EXTS = new Set([
+    '.exe',
+    '.bat',
+    '.cmd',
+    '.msi',
+    '.dmg',
+    '.app',
+    '.com',
+    '.scr',
+]);
+/** All allowed extensions across every category. */
+export const ALLOWED_EXTENSIONS = new Set([
+    ...TEXT_EXTS,
+    ...CODE_EXTS,
+    ...DOC_EXTS,
+    ...IMG_EXTS,
+]);
+const CATEGORY_EXTS = {
+    text: TEXT_EXTS,
+    code: CODE_EXTS,
+    document: DOC_EXTS,
+    image: IMG_EXTS,
+};
+/**
+ * Binary magic-byte signatures keyed by extension. `subSig` is checked at an
+ * offset immediately after `sig` (used by WEBP's RIFF...WEBP layout).
+ * Text-based formats (text/code/svg) are not here — they use UTF-8 validation.
+ */
+export const FILE_SIGNATURES = {
+    '.pdf': { sig: [0x25, 0x50, 0x44, 0x46, 0x2d] },
+    '.doc': { sig: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1] },
+    '.xls': { sig: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1] },
+    '.ppt': { sig: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1] },
+    '.docx': { sig: [0x50, 0x4b, 0x03, 0x04] },
+    '.xlsx': { sig: [0x50, 0x4b, 0x03, 0x04] },
+    '.pptx': { sig: [0x50, 0x4b, 0x03, 0x04] },
+    '.png': { sig: [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a] },
+    '.jpg': { sig: [0xff, 0xd8, 0xff] },
+    '.jpeg': { sig: [0xff, 0xd8, 0xff] },
+    '.gif': { sig: [0x47, 0x49, 0x46, 0x38] }, // GIF8
+    '.webp': { sig: [0x52, 0x49, 0x46, 0x46], subSigAt: 8, subSig: [0x57, 0x45, 0x42, 0x50] }, // RIFF....WEBP
+    '.bmp': { sig: [0x42, 0x4d] }, // BM
+};
+/** Lowercased extension (including leading dot) or '' if none. */
+export function getFileExt(filename) {
+    const lastDot = filename.lastIndexOf('.');
+    return lastDot >= 0 ? filename.substring(lastDot).toLowerCase() : '';
+}
+/**
+ * Resolve the whitelist category for an extension.
+ * Returns null for blocked, unknown, or extension-less files.
+ */
+export function resolveFileCategory(ext) {
+    if (ext === '' || BLOCKED_EXTS.has(ext))
+        return null;
+    for (const cat of FILE_CATEGORIES) {
+        if (CATEGORY_EXTS[cat].includes(ext))
+            return cat;
+    }
+    return null;
+}
+/** UTF-8 decode without throwing — returns null on invalid bytes. */
+function tryUtf8Decode(bytes) {
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    catch {
+        // SILENT-CATCH-OK: tryUtf8Decode returns null on decode failure, caller handles
+        return null;
+    }
+}
+/** True if the head bytes look like SVG (XML text starting with <?xml/<svg/<!DOCTYPE svg). */
+function looksLikeSvg(head) {
+    const s = tryUtf8Decode(head.subarray(0, Math.min(head.length, 512)));
+    if (s === null)
+        return false;
+    const trimmed = (s.charCodeAt(0) === 0xfeff ? s.slice(1) : s).trimStart();
+    return (trimmed.startsWith('<?xml') || trimmed.startsWith('<svg') || trimmed.startsWith('<!DOCTYPE svg'));
+}
+/**
+ * Verify head bytes match the expected type for `ext`.
+ * - text/code: valid UTF-8
+ * - svg: XML text sniff
+ * - binary formats: magic-byte signature (+ optional sub-signature)
+ *
+ * `ext` must already be lowercased (use getFileExt). Buffer is a Uint8Array
+ * subclass, so server/daemon can pass a Buffer directly.
+ */
+export function verifyMagicBytes(head, ext) {
+    if (TEXT_EXTS.includes(ext) || CODE_EXTS.includes(ext)) {
+        return tryUtf8Decode(head) !== null;
+    }
+    if (ext === '.svg') {
+        return looksLikeSvg(head);
+    }
+    const rule = FILE_SIGNATURES[ext];
+    if (!rule)
+        return false;
+    if (head.length < rule.sig.length)
+        return false;
+    for (let i = 0; i < rule.sig.length; i++) {
+        if (head[i] !== rule.sig[i])
+            return false;
+    }
+    if (rule.subSig) {
+        const offset = rule.subSigAt ?? rule.sig.length;
+        if (head.length < offset + rule.subSig.length)
+            return false;
+        for (let i = 0; i < rule.subSig.length; i++) {
+            if (head[offset + i] !== rule.subSig[i])
+                return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=fileWhitelist.js.map