@praveencs/agent 0.1.0

package/dist/src/plans/types.d.ts

@@ -0,0 +1,454 @@
+import { z } from 'zod';
+export interface Goal {
+    id: string;
+    description: string;
+    successCriteria: string[];
+    riskLevel: 'low' | 'medium' | 'high';
+}
+export interface PlanStep {
+    id: string;
+    name: string;
+    description?: string;
+    skill?: string;
+    tool?: string;
+    args?: Record<string, unknown>;
+    verify?: VerifyConfig;
+    onFailure?: 'retry' | 'skip' | 'abort';
+    retries?: number;
+    dependsOn?: string[];
+}
+export interface VerifyConfig {
+    command?: string;
+    fileExists?: string;
+    exitCode?: number;
+    contains?: string;
+}
+export type TriggerType = 'manual' | 'cron' | 'fs_change' | 'git_event' | 'webhook';
+export interface TriggerConfig {
+    type: TriggerType;
+    cron?: string;
+    paths?: string[];
+    gitEvents?: ('commit' | 'push' | 'branch_change')[];
+    webhookPath?: string;
+}
+export interface PlanPolicy {
+    approvals: 'auto' | 'per_step' | 'pre_approve';
+    scope?: {
+        filesystemAllowlist?: string[];
+        commandAllowlist?: string[];
+    };
+}
+export interface OutputConfig {
+    name: string;
+    type: 'file' | 'artifact' | 'log';
+    path?: string;
+}
+export type PlanMode = 'execute' | 'propose';
+export interface Plan {
+    name: string;
+    description: string;
+    mode: PlanMode;
+    goals: Goal[];
+    steps: PlanStep[];
+    policy: PlanPolicy;
+    trigger: TriggerConfig;
+    outputs?: OutputConfig[];
+}
+export interface PlanRun {
+    runId: string;
+    planName: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'aborted' | 'proposed';
+    steps: PlanStepRun[];
+    startedAt?: string;
+    completedAt?: string;
+    triggeredBy: string;
+}
+export interface PlanStepRun {
+    stepId: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    output?: unknown;
+    error?: string;
+    durationMs?: number;
+    verification?: {
+        passed: boolean;
+        details: string;
+    };
+}
+export declare const GoalSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    successCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    riskLevel: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    id: string;
+    successCriteria: string[];
+    riskLevel: "low" | "medium" | "high";
+}, {
+    description: string;
+    id: string;
+    successCriteria?: string[] | undefined;
+    riskLevel?: "low" | "medium" | "high" | undefined;
+}>;
+export declare const VerifySchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodString>;
+    fileExists: z.ZodOptional<z.ZodString>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    contains: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command?: string | undefined;
+    exitCode?: number | undefined;
+    fileExists?: string | undefined;
+    contains?: string | undefined;
+}, {
+    command?: string | undefined;
+    exitCode?: number | undefined;
+    fileExists?: string | undefined;
+    contains?: string | undefined;
+}>;
+export declare const StepSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    skill: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    verify: z.ZodOptional<z.ZodObject<{
+        command: z.ZodOptional<z.ZodString>;
+        fileExists: z.ZodOptional<z.ZodString>;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        contains: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command?: string | undefined;
+        exitCode?: number | undefined;
+        fileExists?: string | undefined;
+        contains?: string | undefined;
+    }, {
+        command?: string | undefined;
+        exitCode?: number | undefined;
+        fileExists?: string | undefined;
+        contains?: string | undefined;
+    }>>;
+    onFailure: z.ZodDefault<z.ZodEnum<["retry", "skip", "abort"]>>;
+    retries: z.ZodDefault<z.ZodNumber>;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    onFailure: "retry" | "skip" | "abort";
+    retries: number;
+    args?: Record<string, unknown> | undefined;
+    description?: string | undefined;
+    tool?: string | undefined;
+    skill?: string | undefined;
+    verify?: {
+        command?: string | undefined;
+        exitCode?: number | undefined;
+        fileExists?: string | undefined;
+        contains?: string | undefined;
+    } | undefined;
+    dependsOn?: string[] | undefined;
+}, {
+    name: string;
+    id: string;
+    args?: Record<string, unknown> | undefined;
+    description?: string | undefined;
+    tool?: string | undefined;
+    skill?: string | undefined;
+    verify?: {
+        command?: string | undefined;
+        exitCode?: number | undefined;
+        fileExists?: string | undefined;
+        contains?: string | undefined;
+    } | undefined;
+    onFailure?: "retry" | "skip" | "abort" | undefined;
+    retries?: number | undefined;
+    dependsOn?: string[] | undefined;
+}>;
+export declare const TriggerSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodEnum<["manual", "cron", "fs_change", "git_event", "webhook"]>>;
+    cron: z.ZodOptional<z.ZodString>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    gitEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<["commit", "push", "branch_change"]>, "many">>;
+    webhookPath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "manual" | "cron" | "fs_change" | "git_event" | "webhook";
+    cron?: string | undefined;
+    paths?: string[] | undefined;
+    gitEvents?: ("push" | "commit" | "branch_change")[] | undefined;
+    webhookPath?: string | undefined;
+}, {
+    type?: "manual" | "cron" | "fs_change" | "git_event" | "webhook" | undefined;
+    cron?: string | undefined;
+    paths?: string[] | undefined;
+    gitEvents?: ("push" | "commit" | "branch_change")[] | undefined;
+    webhookPath?: string | undefined;
+}>;
+export declare const PlanPolicySchema: z.ZodObject<{
+    approvals: z.ZodDefault<z.ZodEnum<["auto", "per_step", "pre_approve"]>>;
+    scope: z.ZodOptional<z.ZodObject<{
+        filesystemAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        commandAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        filesystemAllowlist?: string[] | undefined;
+        commandAllowlist?: string[] | undefined;
+    }, {
+        filesystemAllowlist?: string[] | undefined;
+        commandAllowlist?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    approvals: "auto" | "per_step" | "pre_approve";
+    scope?: {
+        filesystemAllowlist?: string[] | undefined;
+        commandAllowlist?: string[] | undefined;
+    } | undefined;
+}, {
+    scope?: {
+        filesystemAllowlist?: string[] | undefined;
+        commandAllowlist?: string[] | undefined;
+    } | undefined;
+    approvals?: "auto" | "per_step" | "pre_approve" | undefined;
+}>;
+export declare const OutputSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["file", "artifact", "log"]>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "file" | "log" | "artifact";
+    name: string;
+    path?: string | undefined;
+}, {
+    type: "file" | "log" | "artifact";
+    name: string;
+    path?: string | undefined;
+}>;
+export declare const PlanSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<["execute", "propose"]>>;
+    goals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        successCriteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        riskLevel: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        id: string;
+        successCriteria: string[];
+        riskLevel: "low" | "medium" | "high";
+    }, {
+        description: string;
+        id: string;
+        successCriteria?: string[] | undefined;
+        riskLevel?: "low" | "medium" | "high" | undefined;
+    }>, "many">;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        skill: z.ZodOptional<z.ZodString>;
+        tool: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        verify: z.ZodOptional<z.ZodObject<{
+            command: z.ZodOptional<z.ZodString>;
+            fileExists: z.ZodOptional<z.ZodString>;
+            exitCode: z.ZodOptional<z.ZodNumber>;
+            contains: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            command?: string | undefined;
+            exitCode?: number | undefined;
+            fileExists?: string | undefined;
+            contains?: string | undefined;
+        }, {
+            command?: string | undefined;
+            exitCode?: number | undefined;
+            fileExists?: string | undefined;
+            contains?: string | undefined;
+        }>>;
+        onFailure: z.ZodDefault<z.ZodEnum<["retry", "skip", "abort"]>>;
+        retries: z.ZodDefault<z.ZodNumber>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        onFailure: "retry" | "skip" | "abort";
+        retries: number;
+        args?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        tool?: string | undefined;
+        skill?: string | undefined;
+        verify?: {
+            command?: string | undefined;
+            exitCode?: number | undefined;
+            fileExists?: string | undefined;
+            contains?: string | undefined;
+        } | undefined;
+        dependsOn?: string[] | undefined;
+    }, {
+        name: string;
+        id: string;
+        args?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        tool?: string | undefined;
+        skill?: string | undefined;
+        verify?: {
+            command?: string | undefined;
+            exitCode?: number | undefined;
+            fileExists?: string | undefined;
+            contains?: string | undefined;
+        } | undefined;
+        onFailure?: "retry" | "skip" | "abort" | undefined;
+        retries?: number | undefined;
+        dependsOn?: string[] | undefined;
+    }>, "many">;
+    policy: z.ZodDefault<z.ZodObject<{
+        approvals: z.ZodDefault<z.ZodEnum<["auto", "per_step", "pre_approve"]>>;
+        scope: z.ZodOptional<z.ZodObject<{
+            filesystemAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            commandAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            filesystemAllowlist?: string[] | undefined;
+            commandAllowlist?: string[] | undefined;
+        }, {
+            filesystemAllowlist?: string[] | undefined;
+            commandAllowlist?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        approvals: "auto" | "per_step" | "pre_approve";
+        scope?: {
+            filesystemAllowlist?: string[] | undefined;
+            commandAllowlist?: string[] | undefined;
+        } | undefined;
+    }, {
+        scope?: {
+            filesystemAllowlist?: string[] | undefined;
+            commandAllowlist?: string[] | undefined;
+        } | undefined;
+        approvals?: "auto" | "per_step" | "pre_approve" | undefined;
+    }>>;
+    trigger: z.ZodDefault<z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<["manual", "cron", "fs_change", "git_event", "webhook"]>>;
+        cron: z.ZodOptional<z.ZodString>;
+        paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        gitEvents: z.ZodOptional<z.ZodArray<z.ZodEnum<["commit", "push", "branch_change"]>, "many">>;
+        webhookPath: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "manual" | "cron" | "fs_change" | "git_event" | "webhook";
+        cron?: string | undefined;
+        paths?: string[] | undefined;
+        gitEvents?: ("push" | "commit" | "branch_change")[] | undefined;
+        webhookPath?: string | undefined;
+    }, {
+        type?: "manual" | "cron" | "fs_change" | "git_event" | "webhook" | undefined;
+        cron?: string | undefined;
+        paths?: string[] | undefined;
+        gitEvents?: ("push" | "commit" | "branch_change")[] | undefined;
+        webhookPath?: string | undefined;
+    }>>;
+    outputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["file", "artifact", "log"]>;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "file" | "log" | "artifact";
+        name: string;
+        path?: string | undefined;
+    }, {
+        type: "file" | "log" | "artifact";
+        name: string;
+        path?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    policy: {
+        approvals: "auto" | "per_step" | "pre_approve";
+        scope?: {
+            filesystemAllowlist?: string[] | undefined;
+            commandAllowlist?: string[] | undefined;
+        } | undefined;
+    };
+    name: string;
+    description: string;
+    mode: "execute" | "propose";
+    goals: {
+        description: string;
+        id: string;
+        successCriteria: string[];
+        riskLevel: "low" | "medium" | "high";
+    }[];
+    steps: {
+        name: string;
+        id: string;
+        onFailure: "retry" | "skip" | "abort";
+        retries: number;
+        args?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        tool?: string | undefined;
+        skill?: string | undefined;
+        verify?: {
+            command?: string | undefined;
+            exitCode?: number | undefined;
+            fileExists?: string | undefined;
+            contains?: string | undefined;
+        } | undefined;
+        dependsOn?: string[] | undefined;
+    }[];
+    trigger: {
+        type: "manual" | "cron" | "fs_change" | "git_event" | "webhook";
+        cron?: string | undefined;
+        paths?: string[] | undefined;
+        gitEvents?: ("push" | "commit" | "branch_change")[] | undefined;
+        webhookPath?: string | undefined;
+    };
+    outputs?: {
+        type: "file" | "log" | "artifact";
+        name: string;
+        path?: string | undefined;
+    }[] | undefined;
+}, {
+    name: string;
+    description: string;
+    goals: {
+        description: string;
+        id: string;
+        successCriteria?: string[] | undefined;
+        riskLevel?: "low" | "medium" | "high" | undefined;
+    }[];
+    steps: {
+        name: string;
+        id: string;
+        args?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        tool?: string | undefined;
+        skill?: string | undefined;
+        verify?: {
+            command?: string | undefined;
+            exitCode?: number | undefined;
+            fileExists?: string | undefined;
+            contains?: string | undefined;
+        } | undefined;
+        onFailure?: "retry" | "skip" | "abort" | undefined;
+        retries?: number | undefined;
+        dependsOn?: string[] | undefined;
+    }[];
+    policy?: {
+        scope?: {
+            filesystemAllowlist?: string[] | undefined;
+            commandAllowlist?: string[] | undefined;
+        } | undefined;
+        approvals?: "auto" | "per_step" | "pre_approve" | undefined;
+    } | undefined;
+    outputs?: {
+        type: "file" | "log" | "artifact";
+        name: string;
+        path?: string | undefined;
+    }[] | undefined;
+    mode?: "execute" | "propose" | undefined;
+    trigger?: {
+        type?: "manual" | "cron" | "fs_change" | "git_event" | "webhook" | undefined;
+        cron?: string | undefined;
+        paths?: string[] | undefined;
+        gitEvents?: ("push" | "commit" | "branch_change")[] | undefined;
+        webhookPath?: string | undefined;
+    } | undefined;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/plans/types.d.ts.map

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

package/dist/src/plans/types.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+// ─── Zod Schemas for Plan YAML ───
+export const GoalSchema = z.object({
+    id: z.string(),
+    description: z.string(),
+    successCriteria: z.array(z.string()).default([]),
+    riskLevel: z.enum(['low', 'medium', 'high']).default('low'),
+});
+export const VerifySchema = z.object({
+    command: z.string().optional(),
+    fileExists: z.string().optional(),
+    exitCode: z.number().optional(),
+    contains: z.string().optional(),
+});
+export const StepSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    skill: z.string().optional(),
+    tool: z.string().optional(),
+    args: z.record(z.string(), z.unknown()).optional(),
+    verify: VerifySchema.optional(),
+    onFailure: z.enum(['retry', 'skip', 'abort']).default('abort'),
+    retries: z.number().default(0),
+    dependsOn: z.array(z.string()).optional(),
+});
+export const TriggerSchema = z.object({
+    type: z.enum(['manual', 'cron', 'fs_change', 'git_event', 'webhook']).default('manual'),
+    cron: z.string().optional(),
+    paths: z.array(z.string()).optional(),
+    gitEvents: z.array(z.enum(['commit', 'push', 'branch_change'])).optional(),
+    webhookPath: z.string().optional(),
+});
+export const PlanPolicySchema = z.object({
+    approvals: z.enum(['auto', 'per_step', 'pre_approve']).default('per_step'),
+    scope: z.object({
+        filesystemAllowlist: z.array(z.string()).optional(),
+        commandAllowlist: z.array(z.string()).optional(),
+    }).optional(),
+});
+export const OutputSchema = z.object({
+    name: z.string(),
+    type: z.enum(['file', 'artifact', 'log']),
+    path: z.string().optional(),
+});
+export const PlanSchema = z.object({
+    name: z.string().min(1),
+    description: z.string(),
+    mode: z.enum(['execute', 'propose']).default('execute'),
+    goals: z.array(GoalSchema).min(1),
+    steps: z.array(StepSchema).min(1),
+    policy: PlanPolicySchema.default({}),
+    trigger: TriggerSchema.default({ type: 'manual' }),
+    outputs: z.array(OutputSchema).optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/src/plans/types.js.map

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

package/dist/src/policy/audit.d.ts

@@ -0,0 +1,35 @@
+import { EventEmitter } from 'node:events';
+/**
+ * Audit event types
+ */
+export declare enum AuditEventType {
+    TOOL_CALL = "tool_call",
+    TOOL_RESULT = "tool_result",
+    PERMISSION_CHECK = "permission_check",
+    PERMISSION_DENIED = "permission_denied",
+    APPROVAL_GRANTED = "approval_granted",
+    APPROVAL_DENIED = "approval_denied",
+    STEP_START = "step_start",
+    STEP_COMPLETE = "step_complete",
+    STEP_FAILED = "step_failed",
+    RUN_START = "run_start",
+    RUN_COMPLETE = "run_complete",
+    SKILL_LOADED = "skill_loaded",
+    PLAN_PARSED = "plan_parsed",
+    DIFF_GENERATED = "diff_generated"
+}
+export interface AuditEvent {
+    type: AuditEventType;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Typed audit event emitter
+ */
+declare class AuditEmitter extends EventEmitter {
+    emit(type: AuditEventType, data: Record<string, unknown>): boolean;
+    onAudit(handler: (event: AuditEvent) => void): void;
+}
+export declare const auditEmitter: AuditEmitter;
+export {};
+//# sourceMappingURL=audit.d.ts.map

package/dist/src/policy/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/policy/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,oBAAY,cAAc;IACtB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;CACpC;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,cAAM,YAAa,SAAQ,YAAY;IACnC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IASlE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;CAGtD;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/src/policy/audit.js

@@ -0,0 +1,39 @@
+import { EventEmitter } from 'node:events';
+/**
+ * Audit event types
+ */
+export var AuditEventType;
+(function (AuditEventType) {
+    AuditEventType["TOOL_CALL"] = "tool_call";
+    AuditEventType["TOOL_RESULT"] = "tool_result";
+    AuditEventType["PERMISSION_CHECK"] = "permission_check";
+    AuditEventType["PERMISSION_DENIED"] = "permission_denied";
+    AuditEventType["APPROVAL_GRANTED"] = "approval_granted";
+    AuditEventType["APPROVAL_DENIED"] = "approval_denied";
+    AuditEventType["STEP_START"] = "step_start";
+    AuditEventType["STEP_COMPLETE"] = "step_complete";
+    AuditEventType["STEP_FAILED"] = "step_failed";
+    AuditEventType["RUN_START"] = "run_start";
+    AuditEventType["RUN_COMPLETE"] = "run_complete";
+    AuditEventType["SKILL_LOADED"] = "skill_loaded";
+    AuditEventType["PLAN_PARSED"] = "plan_parsed";
+    AuditEventType["DIFF_GENERATED"] = "diff_generated";
+})(AuditEventType || (AuditEventType = {}));
+/**
+ * Typed audit event emitter
+ */
+class AuditEmitter extends EventEmitter {
+    emit(type, data) {
+        const event = {
+            type,
+            timestamp: new Date().toISOString(),
+            data,
+        };
+        return super.emit('audit', event);
+    }
+    onAudit(handler) {
+        this.on('audit', handler);
+    }
+}
+export const auditEmitter = new AuditEmitter();
+//# sourceMappingURL=audit.js.map

package/dist/src/policy/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/policy/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAN,IAAY,cAeX;AAfD,WAAY,cAAc;IACtB,yCAAuB,CAAA;IACvB,6CAA2B,CAAA;IAC3B,uDAAqC,CAAA;IACrC,yDAAuC,CAAA;IACvC,uDAAqC,CAAA;IACrC,qDAAmC,CAAA;IACnC,2CAAyB,CAAA;IACzB,iDAA+B,CAAA;IAC/B,6CAA2B,CAAA;IAC3B,yCAAuB,CAAA;IACvB,+CAA6B,CAAA;IAC7B,+CAA6B,CAAA;IAC7B,6CAA2B,CAAA;IAC3B,mDAAiC,CAAA;AACrC,CAAC,EAfW,cAAc,KAAd,cAAc,QAezB;AAQD;;GAEG;AACH,MAAM,YAAa,SAAQ,YAAY;IACnC,IAAI,CAAC,IAAoB,EAAE,IAA6B;QACpD,MAAM,KAAK,GAAe;YACtB,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI;SACP,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,OAAoC;QACxC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/src/policy/engine.d.ts

@@ -0,0 +1,35 @@
+import type { AgentConfig } from '../config/schema.js';
+import type { ActionDescriptor, ExecutionContext } from '../tools/types.js';
+import type { PermissionResult } from './types.js';
+/**
+ * Policy Engine — enforces permissions, approvals, and scope limits
+ * This is an immutable core component that MUST NOT be modified by autonomous runs.
+ */
+export declare class PolicyEngine {
+    private config;
+    private scopeChecker;
+    private sessionApprovals;
+    constructor(config: AgentConfig, projectRoot: string);
+    /**
+     * Check if an action is permitted based on policy rules
+     */
+    checkPermission(action: ActionDescriptor, ctx: ExecutionContext): Promise<PermissionResult>;
+    /**
+     * Request approval from the user for a specific action
+     */
+    requestApproval(action: ActionDescriptor, ctx: ExecutionContext): Promise<boolean>;
+    /**
+     * Check if a tool invocation is within the configured scope
+     */
+    checkScope(toolName: string, args: Record<string, unknown>): boolean;
+    /**
+     * Grant session-level approval (persists for current run)
+     */
+    grantSessionApproval(action: ActionDescriptor): void;
+    /**
+     * Clear all session approvals
+     */
+    clearSessionApprovals(): void;
+    private findRule;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/policy/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/policy/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAsB,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAInE;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM;IAKpD;;OAEG;IACG,eAAe,CACjB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAoC5B;;OAEG;IACG,eAAe,CACjB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,gBAAgB,GACtB,OAAO,CAAC,OAAO,CAAC;IA+BnB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAgBpE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAMpD;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAM7B,OAAO,CAAC,QAAQ;CAoBnB"}