@aisy/core 0.1.0

package/dist/triggers/types.d.ts

@@ -0,0 +1,74 @@
+import type { Clock, ContextSpan, VerificationTrace } from '../agent-loop/types.js';
+export type { Clock, ContextSpan, VerificationTrace };
+export type TriggerKind = 'remind' | 'schedule' | 'watch';
+export interface TriggerBudget {
+    tokenCeiling: number;
+    dollarCeiling: number;
+    tokensSpent: number;
+    dollarsSpent: number;
+}
+export interface TriggerSpec {
+    id: string;
+    kind: TriggerKind;
+    /** Agent-created triggers require an operator card confirm before firing (ADR-0029). */
+    createdBy: 'operator' | 'agent';
+    /** Writable ONLY via the approval path — never by register() for agent-created. */
+    confirmed: boolean;
+    /** What the woken phase-2 turn is asked to do. */
+    prompt: string;
+    /** remind: one-shot due time (ISO-8601). */
+    fireAt?: string;
+    /** schedule: cron expression (constrained dialect, see spec §10). */
+    cron?: string;
+    /** watch: phase-1 predicate — the ADR-0017 probe set, 0 model tokens. */
+    probe?: VerificationTrace;
+    /** watch: how often phase 1 runs. */
+    intervalMs?: number;
+    budget: TriggerBudget;
+    expiresAt?: string;
+    enabled: boolean;
+    /** Due-slot keys already fired — persisted for crash-safe idempotency (AC-14-14). */
+    firedSlots?: string[];
+}
+export type Phase1Outcome = 'due' | 'condition-met' | 'no-change' | 'budget-paused' | 'skipped';
+export interface TriggerFiring {
+    triggerId: string;
+    firedAt: string;
+    phase1: Phase1Outcome;
+    /** True only when phase 2 actually woke an agent turn. */
+    turnStarted: boolean;
+}
+export interface TriggerStore {
+    load(): Promise<TriggerSpec[]>;
+    save(spec: TriggerSpec): Promise<void>;
+    remove(id: string): Promise<void>;
+}
+export interface TriggerEngineDeps {
+    clock: Clock;
+    /** Shared with agent-loop (ADR-0017); phase 1 never calls a model. */
+    probeRunner(trace: VerificationTrace): Promise<boolean> | boolean;
+    /** Wakes ONE minimal-context agent turn under the trigger's budget. */
+    startTurn(input: {
+        triggerId: string;
+        prompt: string;
+        spans: ContextSpan[];
+        budget: TriggerBudget;
+    }): Promise<void>;
+    store: TriggerStore;
+    emitEvent(event: string, payload: unknown): void;
+    /** Shared cap across ALL background firings (anti-heartbeat-drain, ADR-0038). */
+    globalBackgroundBudget: TriggerBudget;
+    /** Fetch the watched content for the woken turn; stamped untrusted by code. */
+    observe?(trace: VerificationTrace): Promise<string>;
+}
+export interface TriggerEngine {
+    /** Operator-created → active; agent-created → pending confirmation. */
+    register(spec: Omit<TriggerSpec, 'confirmed' | 'enabled'>): Promise<TriggerSpec>;
+    /** The ONLY activation path for agent-created triggers (approval handler calls it). */
+    confirm(triggerId: string): Promise<void>;
+    cancel(triggerId: string): Promise<void>;
+    list(): Promise<TriggerSpec[]>;
+    /** One deterministic scan driven by the injected Clock. */
+    tick(): Promise<TriggerFiring[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/triggers/types.d.ts.map

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

package/dist/triggers/types.js

@@ -0,0 +1,5 @@
+// Component 14 — Triggers & Proactivity. Pure types, no implementation.
+// See docs/specs/14-triggers-and-proactivity.md §3 and ADR-0038.
+// Implementation scheduled for v0.2; the skeleton keeps interfaces honest now.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/triggers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/triggers/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,iEAAiE;AACjE,+EAA+E"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@aisy/core",
+  "version": "0.1.0",
+  "description": "Aisy core — agent loop, memory, safety, provider adapters, and the runtime composition surface.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.10.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc --project tsconfig.build.json"
+  }
+}