@lingxiao-office/sdk 1.0.0

package/dist/contracts/types/Agent.js

@@ -0,0 +1,156 @@
+import { OFFICE_TOOL_NAMES } from '../constants/toolNames.js';
+export const ROLE_SKILL_PRIORITY = [
+    'user_explicit',
+    'leader_explicit',
+    'role_default',
+];
+const BASIC_TOOLS = [
+    'file_read',
+    'file_create',
+    'structured_patch',
+    'code_search',
+    'list_dir',
+    'glob',
+    'shell',
+    'python_exec',
+];
+export const DEFAULT_BASIC_TOOLS = BASIC_TOOLS;
+const TEAM_COMM_TOOLS = ['team_message', 'team_inbox', 'team_manage'];
+const COMM_TOOLS = ['send_message', 'write_work_note', 'read_work_notes', 'request_work_note'];
+const MEMORY_TOOLS = ['memory'];
+function mergeTools(...groups) {
+    return Array.from(new Set(groups.flat().filter(Boolean)));
+}
+function unique(values) {
+    return Array.from(new Set(values.filter(Boolean)));
+}
+export const WORKER_TOOLS = mergeTools(['session_artifacts', 'find_tools', 'tool_preflight', 'parallel_read_batch', 'design_asset'], BASIC_TOOLS, ['web_fetch', 'web_search', 'http_request', 'parse_file'], [...OFFICE_TOOL_NAMES], ['screenshot', 'visual_contact_sheet', 'browser_visual_verify', 'browser_action', 'ocr', 'mcp', 'node_repl'], MEMORY_TOOLS, COMM_TOOLS, TEAM_COMM_TOOLS, ['blackboard'], ['attempt_completion', 'declare_assumption']);
+const ALL_TIERS = ['read', 'compute', 'execute', 'write'];
+export const PRESET_ROLE_PROFILES = {
+    research: {
+        name: 'research',
+        description: '调研分析专家，负责代码库调研和技术方案分析',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    coding: {
+        name: 'coding',
+        description: '代码实现专家，负责编写和修改代码。注意：HTML/PPT/Word/Excel/海报等交付物由 Leader 统一生成，agent 只产出 markdown 写到 scratchpad',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    verify: {
+        name: 'verify',
+        description: '验证测试专家，负责运行测试和验证实现',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    review: {
+        name: 'review',
+        description: '代码审查专家，负责审查代码质量和提出改进建议',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    frontend: {
+        name: 'frontend',
+        description: '前端开发专家，负责 UI/UX 实现、组件开发、样式调试和前端构建',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    backend: {
+        name: 'backend',
+        description: '后端开发专家，负责 API 开发、数据库设计、服务架构和性能优化',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    fullstack: {
+        name: 'fullstack',
+        description: '全栈开发专家，负责前后端契约清晰的小到中型跨栈实现和端到端验证。注意：HTML/PPT/Word/Excel/海报等交付物由 Leader 统一生成，agent 只产出 markdown 写到 scratchpad',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    qa: {
+        name: 'qa',
+        description: '质量保证专家，负责测试策略制定、自动化测试编写和质量门禁把控',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    ux_designer: {
+        name: 'ux_designer',
+        description: '用户体验设计师，负责交互设计、用户体验优化和可用性评估',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    planner: {
+        name: 'planner',
+        description: '规划智能体，负责将简短需求扩展为完整产品规格与编排节点',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    evaluator: {
+        name: 'evaluator',
+        description: '独立评估智能体，负责基于契约和评分标准严格评判生成结果，使用浏览器工具实际测试运行中的应用',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+    architect: {
+        name: 'architect',
+        description: '架构契约责任人。跨栈任务开工前先把前后端共享接口、数据结构、错误码和状态流写成 graph_contract（surface/title/version/content），落到黑板供 frontend/backend worker 消费。不下沉到具体代码实现，由 Leader 派发实现。',
+        tools: [...WORKER_TOOLS],
+        allowedTiers: [...ALL_TIERS],
+        defaultSkillNames: [],
+    },
+};
+export function listPresetRoleProfiles() {
+    return Object.keys(PRESET_ROLE_PROFILES).map((name) => PRESET_ROLE_PROFILES[name]);
+}
+export function createPresetAgentRole(name, systemPrompt = '') {
+    const profile = PRESET_ROLE_PROFILES[name];
+    return {
+        name: profile.name,
+        description: profile.description,
+        systemPrompt,
+        tools: unique([...profile.tools]),
+        skillNames: [...profile.defaultSkillNames],
+        createdBy: 'system',
+        capabilityProfile: {
+            source: 'preset',
+            baselineRole: profile.name,
+            allowedTiers: [...profile.allowedTiers],
+            defaultSkillNames: [...profile.defaultSkillNames],
+            skillPriority: [...ROLE_SKILL_PRIORITY],
+        },
+    };
+}
+export function applyRoleToolsConfig(role, options) {
+    const basicEnabled = options.basicToolsEnabled !== false;
+    const override = options.overrides?.[role.name];
+    let tools = [...role.tools];
+    if (!basicEnabled) {
+        const basicSet = new Set(BASIC_TOOLS);
+        tools = tools.filter((tool) => !basicSet.has(tool) || tool === 'file_read');
+    }
+    if (override?.tools_added && override.tools_added.length > 0) {
+        tools.push(...override.tools_added);
+    }
+    if (override?.tools_removed && override.tools_removed.length > 0) {
+        const removeSet = new Set(override.tools_removed);
+        tools = tools.filter((tool) => !removeSet.has(tool));
+    }
+    return {
+        ...role,
+        tools: unique(tools),
+    };
+}
+//# sourceMappingURL=Agent.js.map

package/dist/contracts/types/Agent.js.map

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

package/dist/contracts/types/Autonomy.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Autonomy Harness core contracts.
+ *
+ * The user-request model is a capability envelope, not a single intent label.
+ * `primaryIntent` summarizes the goal for display, while `grants`, `denies`,
+ * `requiredGates`, `scope`, and `phase` are the policy-bearing fields used by
+ * leader gates and runtime projection.
+ */
+import type { OperationRisk } from './AutonomyDecision.js';
+export type PrimaryIntent = 'diagnose' | 'explain' | 'plan' | 'implement' | 'fix' | 'refactor' | 'verify' | 'operate' | 'research';
+export declare const PRIMARY_INTENTS: readonly ["diagnose", "explain", "plan", "implement", "fix", "refactor", "verify", "operate", "research"];
+export declare function isPrimaryIntent(value: unknown): value is PrimaryIntent;
+export type IntentScopeKind = 'read_only' | 'workspace' | 'selected_paths' | 'project' | 'system' | 'external';
+export declare const INTENT_SCOPE_KINDS: readonly ["read_only", "workspace", "selected_paths", "project", "system", "external"];
+export declare function isIntentScopeKind(value: unknown): value is IntentScopeKind;
+export interface IntentScope {
+    readonly kind: IntentScopeKind;
+    readonly paths?: readonly string[];
+    readonly surfaces?: readonly string[];
+    readonly taskIds?: readonly string[];
+    readonly subsystemIds?: readonly string[];
+    readonly externalTargets?: readonly string[];
+}
+export type IntentPhase = 'understand' | 'design' | 'prepare' | 'execute' | 'verify' | 'finalize' | 'recover';
+export declare const INTENT_PHASES: readonly ["understand", "design", "prepare", "execute", "verify", "finalize", "recover"];
+export declare function isIntentPhase(value: unknown): value is IntentPhase;
+export type Capability = 'read' | 'write' | 'shell' | 'task' | 'dispatch';
+export type CapabilityGrant = Capability;
+export type CapabilityDeny = Capability;
+export declare const CAPABILITIES: readonly ["read", "write", "shell", "task", "dispatch"];
+export declare const CAPABILITY_GRANTS: readonly ["read", "write", "shell", "task", "dispatch"];
+export declare const CAPABILITY_DENIES: readonly ["read", "write", "shell", "task", "dispatch"];
+export declare function isCapability(value: unknown): value is Capability;
+export declare function isCapabilityGrant(value: unknown): value is CapabilityGrant;
+export declare function isCapabilityDeny(value: unknown): value is CapabilityDeny;
+export type RequiredGate = 'confirm_before_write' | 'confirm_before_command' | 'confirm_before_dispatch' | 'confirm_before_workflow_apply' | 'confirm_before_scope_expansion' | 'confirm_before_network' | 'confirm_before_git' | 'confirm_before_permission_change' | 'blueprint_coverage' | 'read_before_write' | 'verify_after_change';
+export declare const REQUIRED_GATES: readonly ["confirm_before_write", "confirm_before_command", "confirm_before_dispatch", "confirm_before_workflow_apply", "confirm_before_scope_expansion", "confirm_before_network", "confirm_before_git", "confirm_before_permission_change", "blueprint_coverage", "read_before_write", "verify_after_change"];
+export declare function isRequiredGate(value: unknown): value is RequiredGate;
+export interface IntentConstraints {
+    readonly maxRisk?: OperationRisk;
+    readonly allowedTools?: readonly string[];
+    readonly deniedTools?: readonly string[];
+    readonly allowedPaths?: readonly string[];
+    readonly deniedPaths?: readonly string[];
+    readonly commandAllowlist?: readonly string[];
+    readonly commandDenylist?: readonly string[];
+    readonly mustStayWithinBlueprint?: boolean;
+    readonly requireEvidence?: boolean;
+}
+export interface CapabilityIntentProfile {
+    readonly primaryIntent: PrimaryIntent;
+    readonly scope: IntentScope;
+    readonly phase: IntentPhase;
+    readonly grants: readonly CapabilityGrant[];
+    readonly denies: readonly CapabilityDeny[];
+    readonly requiredGates: readonly RequiredGate[];
+    readonly constraints: IntentConstraints;
+    readonly confidence: number;
+    readonly reason: string;
+    readonly turnId: number | null;
+    readonly recordedAt: number;
+    readonly source: 'record_capability_intent' | 'runtime_default' | string;
+}
+export type AutonomyMode = 'review_first' | 'balanced' | 'autonomous';
+export declare const AUTONOMY_MODES: readonly ["review_first", "balanced", "autonomous"];
+export declare const AUTONOMY_MODE_ALIASES: {
+    readonly full_auto: "autonomous";
+};
+export declare const DEFAULT_AUTONOMY_MODE: AutonomyMode;
+export declare function isAutonomyMode(value: unknown): value is AutonomyMode;
+export declare function coerceAutonomyModeAlias(value: unknown): unknown;
+export declare function normalizeAutonomyMode(value: unknown): AutonomyMode;
+export type AutonomyLifecyclePhase = 'bootstrap' | 'active' | 'recovery' | 'stable';
+export declare const AUTONOMY_LIFECYCLE_PHASES: readonly ["bootstrap", "active", "recovery", "stable"];
+export declare const DEFAULT_AUTONOMY_LIFECYCLE_PHASE: AutonomyLifecyclePhase;
+export declare function isAutonomyLifecyclePhase(value: unknown): value is AutonomyLifecyclePhase;
+export declare function normalizeAutonomyLifecyclePhase(value: unknown): AutonomyLifecyclePhase;
+export type AutonomyDecisionKind = 'allow' | 'dry_run_only' | 'require_confirmation' | 'forbid' | 'escalate_to_leader';
+export declare const AUTONOMY_DECISION_KINDS: readonly ["allow", "dry_run_only", "require_confirmation", "forbid", "escalate_to_leader"];
+export declare function isAutonomyDecisionKind(value: unknown): value is AutonomyDecisionKind;
+export interface AutonomyDecision {
+    kind: AutonomyDecisionKind;
+    intentProfile: CapabilityIntentProfile;
+    autonomyMode: AutonomyMode;
+    reason: string;
+    affectedTools: readonly string[];
+}
+//# sourceMappingURL=Autonomy.d.ts.map

package/dist/contracts/types/Autonomy.d.ts.map

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

package/dist/contracts/types/Autonomy.js

@@ -0,0 +1,126 @@
+/**
+ * Autonomy Harness core contracts.
+ *
+ * The user-request model is a capability envelope, not a single intent label.
+ * `primaryIntent` summarizes the goal for display, while `grants`, `denies`,
+ * `requiredGates`, `scope`, and `phase` are the policy-bearing fields used by
+ * leader gates and runtime projection.
+ */
+export const PRIMARY_INTENTS = [
+    'diagnose',
+    'explain',
+    'plan',
+    'implement',
+    'fix',
+    'refactor',
+    'verify',
+    'operate',
+    'research',
+];
+export function isPrimaryIntent(value) {
+    return typeof value === 'string' && PRIMARY_INTENTS.includes(value);
+}
+export const INTENT_SCOPE_KINDS = [
+    'read_only',
+    'workspace',
+    'selected_paths',
+    'project',
+    'system',
+    'external',
+];
+export function isIntentScopeKind(value) {
+    return typeof value === 'string' && INTENT_SCOPE_KINDS.includes(value);
+}
+export const INTENT_PHASES = [
+    'understand',
+    'design',
+    'prepare',
+    'execute',
+    'verify',
+    'finalize',
+    'recover',
+];
+export function isIntentPhase(value) {
+    return typeof value === 'string' && INTENT_PHASES.includes(value);
+}
+export const CAPABILITIES = [
+    'read',
+    'write',
+    'shell',
+    'task',
+    'dispatch',
+];
+export const CAPABILITY_GRANTS = CAPABILITIES;
+export const CAPABILITY_DENIES = CAPABILITIES;
+export function isCapability(value) {
+    return typeof value === 'string' && CAPABILITIES.includes(value);
+}
+export function isCapabilityGrant(value) {
+    return isCapability(value);
+}
+export function isCapabilityDeny(value) {
+    return isCapability(value);
+}
+export const REQUIRED_GATES = [
+    'confirm_before_write',
+    'confirm_before_command',
+    'confirm_before_dispatch',
+    'confirm_before_workflow_apply',
+    'confirm_before_scope_expansion',
+    'confirm_before_network',
+    'confirm_before_git',
+    'confirm_before_permission_change',
+    'blueprint_coverage',
+    'read_before_write',
+    'verify_after_change',
+];
+export function isRequiredGate(value) {
+    return typeof value === 'string' && REQUIRED_GATES.includes(value);
+}
+export const AUTONOMY_MODES = [
+    'review_first',
+    'balanced',
+    'autonomous',
+];
+export const AUTONOMY_MODE_ALIASES = {
+    full_auto: 'autonomous',
+};
+export const DEFAULT_AUTONOMY_MODE = 'balanced';
+export function isAutonomyMode(value) {
+    return typeof value === 'string' && AUTONOMY_MODES.includes(value);
+}
+export function coerceAutonomyModeAlias(value) {
+    if (typeof value !== 'string')
+        return value;
+    const normalized = value.trim();
+    return AUTONOMY_MODE_ALIASES[normalized] ?? normalized;
+}
+export function normalizeAutonomyMode(value) {
+    const canonical = coerceAutonomyModeAlias(value);
+    return isAutonomyMode(canonical) ? canonical : DEFAULT_AUTONOMY_MODE;
+}
+export const AUTONOMY_LIFECYCLE_PHASES = [
+    'bootstrap',
+    'active',
+    'recovery',
+    'stable',
+];
+export const DEFAULT_AUTONOMY_LIFECYCLE_PHASE = 'bootstrap';
+export function isAutonomyLifecyclePhase(value) {
+    return typeof value === 'string' && AUTONOMY_LIFECYCLE_PHASES.includes(value);
+}
+export function normalizeAutonomyLifecyclePhase(value) {
+    return isAutonomyLifecyclePhase(value) ? value : DEFAULT_AUTONOMY_LIFECYCLE_PHASE;
+}
+export const AUTONOMY_DECISION_KINDS = [
+    'allow',
+    'dry_run_only',
+    'require_confirmation',
+    'forbid',
+    'escalate_to_leader',
+];
+export function isAutonomyDecisionKind(value) {
+    return (typeof value === 'string' &&
+        AUTONOMY_DECISION_KINDS.includes(value));
+}
+//# sourceMappingURL=Autonomy.js.map

package/dist/contracts/types/Autonomy.js.map

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

package/dist/contracts/types/AutonomyDecision.d.ts

@@ -0,0 +1,48 @@
+/**
+ * AutonomyDecisionEngine input/output contracts.
+ *
+ * The decision axis is capability profile × action × risk, with autonomy and
+ * permission modes applied as overlays. `primaryIntent` is display context; it
+ * is not a permission boundary.
+ */
+import type { AutonomyDecision as BaseAutonomyDecision, AutonomyMode, CapabilityGrant, CapabilityIntentProfile } from './Autonomy.js';
+export { AUTONOMY_DECISION_KINDS, AUTONOMY_MODES, CAPABILITIES, CAPABILITY_DENIES, CAPABILITY_GRANTS, DEFAULT_AUTONOMY_MODE, INTENT_PHASES, INTENT_SCOPE_KINDS, PRIMARY_INTENTS, REQUIRED_GATES, isAutonomyDecisionKind, isAutonomyMode, isCapability, isCapabilityDeny, isCapabilityGrant, isIntentPhase, isIntentScopeKind, isPrimaryIntent, isRequiredGate, normalizeAutonomyMode, } from './Autonomy.js';
+export type { AutonomyDecisionKind, AutonomyMode, Capability, CapabilityDeny, CapabilityGrant, CapabilityIntentProfile, IntentConstraints, IntentPhase, IntentScope, IntentScopeKind, PrimaryIntent, RequiredGate, } from './Autonomy.js';
+export type AutonomyAction = 'read' | 'analyze' | 'propose' | 'apply_change' | 'dispatch' | 'workflow_apply' | 'run_command' | 'create_task' | 'scope_expand';
+export declare const AUTONOMY_ACTIONS: readonly ["read", "analyze", "propose", "apply_change", "dispatch", "workflow_apply", "run_command", "create_task", "scope_expand"];
+export declare function isAutonomyAction(value: unknown): value is AutonomyAction;
+export type OperationRisk = 'low' | 'medium' | 'high' | 'critical';
+export declare const OPERATION_RISKS: readonly ["low", "medium", "high", "critical"];
+export declare function isOperationRisk(value: unknown): value is OperationRisk;
+export type AutonomyDecisionSource = 'intent_profile' | 'autonomy_default' | 'autonomy_explicit' | 'capability_grant' | 'capability_deny' | 'required_gate' | 'intent_constraint' | 'scope_match' | 'path_constraint' | 'command_constraint' | 'blueprint_coverage' | 'rule_action' | 'rule_permission';
+export interface AutonomyDecisionEvidence {
+    kind: 'primary_intent' | 'intent_phase' | 'intent_scope' | 'autonomy_mode' | 'permission_mode' | 'control_mode' | 'leader_execution_mode' | 'tool_tier' | 'operation_risk' | 'read_only_flag' | 'rule_action' | 'capability_grant' | 'capability_deny' | 'required_gate' | 'intent_constraint' | 'scope_match' | 'path_constraint' | 'command_constraint' | 'blueprint_coverage' | 'rule_permission' | 'rule_hit';
+    value: string;
+    note?: string;
+}
+export interface BlueprintGateSnapshot {
+    readyToDispatch: boolean;
+    uncoveredSubsystemIds: readonly string[];
+}
+export interface AutonomyDecisionContext {
+    intentProfile: CapabilityIntentProfile;
+    autonomyMode: AutonomyMode;
+    permissionMode?: 'strict' | 'dev' | 'networked' | 'yolo' | undefined;
+    leaderExecutionMode?: 'direct' | 'hybrid' | 'delegate' | undefined;
+    controlMode?: 'manual' | 'eternal' | undefined;
+    toolTier?: 'read' | 'compute' | 'write' | 'execute' | undefined;
+    action?: AutonomyAction | undefined;
+    operationRisk: OperationRisk;
+    isReadOnly: boolean;
+    toolName?: string | undefined;
+    targetPaths?: readonly string[] | undefined;
+    command?: string | undefined;
+    scopeExpansion?: boolean | undefined;
+    blueprintCoverage?: BlueprintGateSnapshot | null | undefined;
+}
+export interface AutonomyDecision extends BaseAutonomyDecision {
+    source: AutonomyDecisionSource;
+    evidence: readonly AutonomyDecisionEvidence[];
+    requiredCapability?: CapabilityGrant | null;
+}
+//# sourceMappingURL=AutonomyDecision.d.ts.map

package/dist/contracts/types/AutonomyDecision.d.ts.map

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

package/dist/contracts/types/AutonomyDecision.js

@@ -0,0 +1,27 @@
+/**
+ * AutonomyDecisionEngine input/output contracts.
+ *
+ * The decision axis is capability profile × action × risk, with autonomy and
+ * permission modes applied as overlays. `primaryIntent` is display context; it
+ * is not a permission boundary.
+ */
+export { AUTONOMY_DECISION_KINDS, AUTONOMY_MODES, CAPABILITIES, CAPABILITY_DENIES, CAPABILITY_GRANTS, DEFAULT_AUTONOMY_MODE, INTENT_PHASES, INTENT_SCOPE_KINDS, PRIMARY_INTENTS, REQUIRED_GATES, isAutonomyDecisionKind, isAutonomyMode, isCapability, isCapabilityDeny, isCapabilityGrant, isIntentPhase, isIntentScopeKind, isPrimaryIntent, isRequiredGate, normalizeAutonomyMode, } from './Autonomy.js';
+export const AUTONOMY_ACTIONS = [
+    'read',
+    'analyze',
+    'propose',
+    'apply_change',
+    'dispatch',
+    'workflow_apply',
+    'run_command',
+    'create_task',
+    'scope_expand',
+];
+export function isAutonomyAction(value) {
+    return typeof value === 'string' && AUTONOMY_ACTIONS.includes(value);
+}
+export const OPERATION_RISKS = ['low', 'medium', 'high', 'critical'];
+export function isOperationRisk(value) {
+    return typeof value === 'string' && OPERATION_RISKS.includes(value);
+}
+//# sourceMappingURL=AutonomyDecision.js.map

package/dist/contracts/types/AutonomyDecision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutonomyDecision.js","sourceRoot":"","sources":["../../../src/contracts/types/AutonomyDecision.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,eAAe,CAAC;AA8BvB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,SAAS;IACT,SAAS;IACT,cAAc;IACd,UAAU;IACV,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,cAAc;CACN,CAAC;AAEX,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAMD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAE9E,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC"}

package/dist/contracts/types/Canvas.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Canvas — 剑阁可交互 Canvas 的核心契约类型
+ *
+ * 解决的根本问题：用户看到的是「成品」（HTML 渲染 / PPTX / 图片），
+ * 要改的是「源码」（结构化 spec / 生成脚本 / HTML 源）。中间隔着一次渲染。
+ * 本契约定义「源码 ↔ 成品」双向映射所需的全部数据结构。
+ *
+ * 映射采用 both_layered 分层模型：
+ *   - spec 主干   产物由结构化 spec(JSON) 驱动，锚点指向 spec 节点路径，
+ *                改动 = 改 spec 字段 → 重新装配。稳定、精确、可回滚、天然版本栈。
+ *   - script 兜底 产物由自由脚本(gen_xx.cjs / 手写 HTML)生成，锚点指向源文件
+ *                行号区间，改动 = LLM 改脚本对应行 → 重跑命令。覆盖自由产物。
+ *
+ * 核心模型：
+ *   1. SourceProvenance —— 生成期注入到每个可交互单元的统一锚点（spec | script）
+ *   2. CanvasSourceMap  —— 一份产物的完整映射表（nodeId ↔ 锚点）
+ *   3. CanvasVersion    —— 版本快照（version_stack：每次改完入栈，可回退对比）
+ *   4. SelectionIntent  —— 用户选区 + 自然语言意图，打包交给 LLM
+ *   5. CanvasComment    —— 结构化批注（替代一次性纯文本 prompt）
+ */
+/** 锚点类型：both_layered 分层映射的两种源码锚定方式。 */
+export type SourceAnchorKind = 'spec' | 'script';
+/**
+ * spec 锚点：指向结构化 spec 中的一个节点。
+ * 落到 HTML 上即：
+ *   data-node-id="slides.3.title" data-anchor="spec" data-spec-path="slides[3].title"
+ */
+export interface SpecAnchor {
+    kind: 'spec';
+    /** 稳定语义 ID，跨重新生成保持不变。如 "slides.3.title" */
+    nodeId: string;
+    /** spec 节点路径（JSON path 风格），如 "slides[3].title"。改这里就改产物 */
+    specPath: string;
+    /** 可选：语义角色，便于 LLM 理解，如 "title" | "subtitle" | "chart" */
+    role?: string;
+}
+/**
+ * script 锚点：指向自由脚本/手写 HTML 的源码行号区间。
+ * 落到 HTML 上即：
+ *   data-node-id="cover.title" data-anchor="script" data-src-file="gen_deck.cjs" data-src-range="84-88"
+ */
+export interface ScriptAnchor {
+    kind: 'script';
+    /** 稳定语义 ID。如 "cover.title" */
+    nodeId: string;
+    /** 生成它的源文件（相对 workspace 路径），如 "gen_deck.cjs" */
+    srcFile: string;
+    /** 对应源码行号区间 [startLine, endLine]，1-based，含两端 */
+    srcRange: [number, number];
+    /** 可选：语义角色 */
+    role?: string;
+}
+/**
+ * 溯源标记：生成期注入到每个可交互 DOM 单元的统一锚点（spec 或 script）。
+ * 上层 Canvas 逻辑统一按 SourceProvenance 处理，按 kind 分派到对应回写路径。
+ */
+export type SourceProvenance = SpecAnchor | ScriptAnchor;
+/**
+ * 一份产物的完整源码映射表。持久化到
+ * .lingxiao/canvas/<artifactId>/sourcemap.json
+ */
+export interface CanvasSourceMap {
+    /** 产物稳定 ID（通常是产物相对路径的规范化形式） */
+    artifactId: string;
+    /** 当前产物文件路径（HTML 可交互源），相对 workspace */
+    artifactPath: string;
+    /** 该产物的主导锚点类型：spec 主干 或 script 兜底 */
+    anchorKind: SourceAnchorKind;
+    /** spec 主干模式下的 spec 文件（相对 workspace），如 "deck.spec.json" */
+    specFile?: string;
+    /** script 兜底模式下的生成脚本入口（相对 workspace），如 "gen_deck.cjs" */
+    generatorFile?: string;
+    /** 重新生成产物的命令（让回写闭环能自动重跑），如 "node gen_deck.cjs" */
+    regenerateCommand?: string;
+    /** 所有可交互单元的溯源标记 */
+    nodes: SourceProvenance[];
+    /** 生成时间戳 */
+    generatedAt: number;
+}
+/** 版本快照在版本栈中的状态 */
+export type CanvasVersionStatus = 'active' | 'superseded' | 'reverted';
+/**
+ * 版本快照：version_stack 的一个节点。
+ * 每次 LLM 改完源码 + 重新生成，新产物作为新版本入栈，可回退到任意历史版本对比。
+ */
+export interface CanvasVersion {
+    /** 版本号，从 1 递增 */
+    version: number;
+    /** 该版本产物快照路径（相对 workspace），如 ".lingxiao/canvas/<id>/versions/v2.html"。快照失败或首版可空 */
+    snapshotPath?: string;
+    /** 触发该版本的用户意图摘要（首版为空） */
+    intent?: string;
+    /** 相对上一版本改动的文件列表 */
+    changedFiles?: string[];
+    status: CanvasVersionStatus;
+    createdAt: number;
+}
+/**
+ * 选区意图：用户在 Canvas 上点选/框选一个元素 + 写下自然语言诉求，
+ * 打包成这个结构交给 Leader/LLM。这是「成品交互」翻译成「源码修改」的桥梁。
+ */
+export interface SelectionIntent {
+    /** 选中单元的稳定语义 ID（来自 SourceProvenance.nodeId） */
+    nodeId: string;
+    /** 选中单元的锚点（spec 或 script），决定 LLM 走哪条回写路径 */
+    anchor: SourceProvenance;
+    /** 选中单元当前的内容/文本快照（给 LLM 做定位佐证） */
+    currentContent?: string;
+    /** 用户的自然语言诉求，如 "标题再大一点，加一道金色描边" */
+    userIntent: string;
+    /** 产物 ID */
+    artifactId: string;
+    /** 可选：归一化选区框（0..1），用于在渲染图上回显高亮 */
+    selectionBox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    /** 发起时间 */
+    createdAt: number;
+}
+/** 结构化批注的处理状态 */
+export type CanvasCommentStatus = 'pending' | 'applied' | 'dismissed';
+/**
+ * 结构化批注：替代当前「一次性纯文本 prompt」。
+ * 支持多条评论、定位回跳、状态追踪，持久化到
+ * .lingxiao/canvas/<artifactId>/comments.json
+ */
+export interface CanvasComment {
+    /** 批注唯一 ID */
+    id: string;
+    /** 锚定的产物 ID */
+    artifactId: string;
+    /** 锚定的语义单元 ID（可空，表示对整页的评论） */
+    nodeId?: string;
+    /** 锚定时产物的版本号 */
+    version: number;
+    /** 批注正文 */
+    body: string;
+    /** 归一化选区框，用于在 Canvas 上回显批注气泡位置 */
+    selectionBox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    status: CanvasCommentStatus;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * 一份产物在 Canvas 中的完整状态聚合，对应
+ * .lingxiao/canvas/<artifactId>/ 目录。
+ */
+export interface CanvasArtifactState {
+    artifactId: string;
+    sourceMap: CanvasSourceMap;
+    versions: CanvasVersion[];
+    activeVersion: number;
+    comments: CanvasComment[];
+}
+//# sourceMappingURL=Canvas.d.ts.map