@pi-orca/core 0.0.2-dev.20260413162335

package/README.md

@@ -0,0 +1,228 @@
+# @pi-orca/core
+
+**Shared types and utilities for Pi Orca extension suite**
+
+Version: 0.0.1  
+License: MIT
+
+## Overview
+
+`@pi-orca/core` is the foundation package for the Pi Orca multi-agent extension suite. It provides shared TypeScript types, utilities, and configuration helpers used by all Pi Orca extensions.
+
+## Features
+
+- **Type Definitions** — Complete TypeScript types for tasks, agents, messages, teams, and configuration
+- **Label Filtering** — Flexible label matching with special values (`_unset`, `_empty`, `_blank`)
+- **Filesystem Utilities** — Atomic writes, path resolution, YAML frontmatter parsing
+- **Lock Management** — Multi-session lock files with PID-based staleness detection
+- **DAG Utilities** — Cycle detection and transitive dependency walking for task graphs
+- **Heartbeat System** — Periodic status file writes with cost tracking
+- **Duration Parsing** — Human-readable duration strings (`30s`, `5m`, `2h`, `7d`)
+
+## Installation
+
+```bash
+npm install @pi-orca/core
+```
+
+## Usage
+
+### Types
+
+```typescript
+import { Task, TaskStatus, AgentTemplate, Labels } from "@pi-orca/core";
+
+const task: Task = {
+  id: "task-001",
+  title: "Implement feature",
+  status: "pending",
+  // ... other fields
+};
+```
+
+### Label Filtering
+
+```typescript
+import { matchLabels, LABEL_BLANK } from "@pi-orca/core";
+
+const entityLabels = { team: "frontend", priority: "high" };
+const filter = { team: "frontend" };
+
+if (matchLabels(entityLabels, filter)) {
+  console.log("Labels match!");
+}
+
+// Find unassigned tasks
+const unassignedFilter = { assignedTo: LABEL_BLANK };
+```
+
+### Filesystem Utilities
+
+```typescript
+import { 
+  atomicWrite, 
+  parseFrontmatter, 
+  serializeFrontmatter,
+  bootstrapFile 
+} from "@pi-orca/core";
+
+// Atomic file write
+await atomicWrite("/path/to/file.md", content);
+
+// Parse markdown with YAML frontmatter
+const { frontmatter, body } = parseFrontmatter<Task>(content);
+
+// Serialize to markdown
+const markdown = serializeFrontmatter(frontmatter, body);
+
+// Bootstrap config file with defaults
+const { created, content } = await bootstrapFile(
+  "/path/to/config.yaml",
+  defaultConfig,
+  { notify: true }
+);
+```
+
+### Lock Management
+
+```typescript
+import { acquireLock, releaseLock, isLockStale } from "@pi-orca/core";
+
+const lockPath = "/path/to/task.lock";
+const lockInfo = {
+  sessionId: "abc123",
+  sessionPath: "project/session.jsonl",
+  pid: process.pid,
+  acquiredAt: new Date().toISOString(),
+};
+
+// Acquire lock
+if (await acquireLock(lockPath, lockInfo)) {
+  console.log("Lock acquired");
+} else {
+  console.log("Lock held by another session");
+}
+
+// Check if lock is stale
+if (await isLockStale(lockPath)) {
+  console.log("Lock is stale (PID dead)");
+}
+
+// Release lock
+await releaseLock(lockPath, "abc123");
+```
+
+### DAG Utilities
+
+```typescript
+import { detectCycle, getTransitiveDependents } from "@pi-orca/core";
+
+const dependencies = new Map([
+  ["task-001", ["task-002"]],
+  ["task-002", ["task-003"]],
+]);
+
+// Detect cycles
+const cycle = detectCycle("task-003", "task-001", dependencies);
+if (cycle) {
+  console.log("Cycle detected:", cycle);
+}
+
+// Get transitive dependents
+const dependents = getTransitiveDependents("task-002", dependentsMap);
+```
+
+### Heartbeat
+
+```typescript
+import { createHeartbeat } from "@pi-orca/core";
+
+const heartbeat = createHeartbeat({
+  filePath: "/path/to/status.yaml",
+  intervalMs: 30000, // 30 seconds
+  updateFn: (data) => ({
+    ...data,
+    status: "running",
+    // Additional status fields
+  }),
+});
+
+heartbeat.start();
+
+// Update accumulated data
+heartbeat.update({ inputTokens: 1000, outputTokens: 500 });
+
+// Stop heartbeat
+heartbeat.stop();
+```
+
+### Path Utilities
+
+```typescript
+import { 
+  getOrcaRuntimeDir,
+  getOrcaTasksDir,
+  getUserOrcaDir,
+  getProjectOrcaDir 
+} from "@pi-orca/core";
+
+const runtimeDir = getOrcaRuntimeDir(); // ~/.pi/agent/sessions/<slug>/orca/
+const tasksDir = getOrcaTasksDir(); // .../orca/tasks/
+const userDir = getUserOrcaDir(); // ~/.pi/agent/orca/
+const projectDir = getProjectOrcaDir(); // <project>/.pi/orca/
+```
+
+## API Documentation
+
+### Types
+
+- `Labels` — Key-value string pairs
+- `LabelFilter` — Filter with special values support
+- `Archivable` — Interface for cleanup-eligible entities
+- `OrcaConfig` — Shared configuration schema
+- `Task`, `TaskStatus` — Task types and state machine
+- `AgentTemplate`, `AgentStatus`, `AgentStatusFile` — Agent types
+- `Message`, `InboxRef` — Message types
+- `TeamTemplate` — Team composition schema
+- `LockInfo` — Lock file schema
+
+### Utilities
+
+- **Duration**: `parseDuration()`, `formatDuration()`
+- **Path**: `getOrcaRuntimeDir()`, `getOrcaTasksDir()`, `getUserOrcaDir()`, etc.
+- **YAML**: `parseFrontmatter()`, `serializeFrontmatter()`
+- **Filesystem**: `atomicWrite()`, `ensureDir()`, `bootstrapFile()`
+- **Lock**: `acquireLock()`, `releaseLock()`, `isLockStale()`
+- **Process**: `isPidAlive()`, `getCurrentPid()`
+- **DAG**: `detectCycle()`, `getTransitiveDependents()`, `getTransitiveDependencies()`
+- **Heartbeat**: `createHeartbeat()`
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode
+npm run test:watch
+
+# Type check
+npm run typecheck
+```
+
+## Related Packages
+
+- `@pi-orca/tasks` — Task management extension
+- `@pi-orca/messages` — Inter-session messaging
+- `@pi-orca/models` — Model alias management
+- `@pi-orca/agents` — Subagent lifecycle management
+- `@pi-orca/teams` — Team orchestration
+- `@pi-orca/cleanup` — Retention and cleanup
+- `@pi-orca/profiles` — Extension profiles
+
+## License
+
+MIT License — see [LICENSE](../../LICENSE) for details.

package/defaults/config.yaml

@@ -0,0 +1,28 @@
+# Pi Orca — Shared Configuration
+# Spec: §2.2 — Shared Configuration
+#
+# This file contains cross-cutting settings shared by multiple extensions.
+# Project config (.pi/orca/config.yaml) overrides user config (~/.pi/agent/orca/config.yaml).
+
+# Polling intervals and heartbeat configuration
+polling:
+  # Message + agent status polling when session is idle (seconds)
+  idleIntervalSeconds: 30
+
+  # Agent heartbeat write interval (seconds)
+  heartbeatIntervalSeconds: 30
+
+  # Heartbeat staleness threshold = dead agent (seconds)
+  # If no heartbeat for this duration, agent is considered stuck
+  stuckThresholdSeconds: 120
+
+# Parent liveness and shutdown protocol
+parentLiveness:
+  # Prompt before orphaning children on shutdown
+  shutdownGuard: true
+
+  # Children detect dead parents and shut down gracefully
+  childSelfRescue: true
+
+  # Grace period to finish current task before shutting down (seconds)
+  orphanGracePeriodSeconds: 60

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Pi Orca Core
+ * Shared types and utilities for Pi Orca extension suite.
+ * Spec: §2 — Cross-Cutting Concerns
+ */
+export * from "./types/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * Pi Orca Core
+ * Shared types and utilities for Pi Orca extension suite.
+ * Spec: §2 — Cross-Cutting Concerns
+ */
+export * from "./types/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/types/agent.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Agent types and templates.
+ * Spec: §5 — pi-orca-agents Extension
+ */
+import { Labels } from "./labels.js";
+/**
+ * Agent status values.
+ * Spec: §5.5 — Per-Agent Status Files
+ */
+export type AgentStatus = "running" | "completed" | "failed" | "orphaned";
+/**
+ * Agent isolation mode.
+ * Spec: §5.2 — Agent Template Schema
+ */
+export type AgentIsolation = "sdk" | "process" | "tmux";
+/**
+ * Agent context mode.
+ * Spec: §5.2
+ */
+export type AgentContext = "fresh" | "fork";
+/**
+ * Restrictions mode for tools.
+ * Spec: §5.2
+ */
+export type RestrictionsMode = "override" | "extend";
+/**
+ * Agent template schema (YAML frontmatter).
+ * Spec: §5.2 — Agent Template Schema
+ */
+export interface AgentTemplate {
+    name: string;
+    description: string;
+    model: string;
+    thinking?: string;
+    context: AgentContext;
+    tools?: string[];
+    skills?: string[];
+    restrictions?: string[];
+    restrictionsMode: RestrictionsMode;
+    isolation: AgentIsolation;
+    completionNotify: "parent";
+    labels: Labels;
+}
+/**
+ * Per-agent status file schema.
+ * Spec: §5.5 — Per-Agent Status Files
+ */
+export interface AgentStatusFile {
+    agentId: string;
+    templateName: string;
+    sessionId: string;
+    sessionPath: string;
+    parentSessionId: string;
+    parentSessionPath: string;
+    rootSessionPath: string;
+    pid: number;
+    isolation: AgentIsolation;
+    model: string;
+    context: AgentContext;
+    spawnedAt: string;
+    status: AgentStatus;
+    lastHeartbeat: string;
+    exitReason: string;
+    result: string;
+    labels: Labels;
+    cost: {
+        inputTokens: number;
+        outputTokens: number;
+        totalCost: number;
+    };
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH"}

package/dist/types/agent.js

@@ -0,0 +1,6 @@
+/**
+ * Agent types and templates.
+ * Spec: §5 — pi-orca-agents Extension
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/archivable.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Archivable convention for cleanup.
+ * Spec: §2.4 — Archivable Convention
+ */
+/**
+ * Entities that support archival must implement this interface.
+ */
+export interface Archivable {
+    /** Eligible for cleanup sweep */
+    archivable: boolean;
+    /** ISO 8601 timestamp when entity reached terminal state */
+    completedAt: string;
+}
+/**
+ * Check if an entity is eligible for archival based on age.
+ * Spec: §2.4
+ *
+ * @param entity - Entity with archivable fields
+ * @param maxAge - Duration string (e.g., "7d", "14d", "3d")
+ * @returns true if archivable and older than maxAge
+ */
+export declare function isArchivable(entity: Archivable, maxAge: string): boolean;
+//# sourceMappingURL=archivable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archivable.d.ts","sourceRoot":"","sources":["../../src/types/archivable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAcxE"}

package/dist/types/archivable.js

@@ -0,0 +1,47 @@
+/**
+ * Archivable convention for cleanup.
+ * Spec: §2.4 — Archivable Convention
+ */
+/**
+ * Check if an entity is eligible for archival based on age.
+ * Spec: §2.4
+ *
+ * @param entity - Entity with archivable fields
+ * @param maxAge - Duration string (e.g., "7d", "14d", "3d")
+ * @returns true if archivable and older than maxAge
+ */
+export function isArchivable(entity, maxAge) {
+    if (!entity.archivable || !entity.completedAt) {
+        return false;
+    }
+    const completedDate = new Date(entity.completedAt);
+    if (isNaN(completedDate.getTime())) {
+        return false;
+    }
+    const maxAgeMs = parseDuration(maxAge);
+    const age = Date.now() - completedDate.getTime();
+    return age >= maxAgeMs;
+}
+/**
+ * Parse a duration string to milliseconds.
+ * Supports: 30s, 5m, 2h, 7d
+ *
+ * @param input - Duration string
+ * @returns Milliseconds
+ */
+function parseDuration(input) {
+    const match = input.match(/^(\d+)([smhd])$/);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${input}`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    const multipliers = {
+        s: 1000,
+        m: 60 * 1000,
+        h: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+    };
+    return value * multipliers[unit];
+}
+//# sourceMappingURL=archivable.js.map

package/dist/types/archivable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivable.js","sourceRoot":"","sources":["../../src/types/archivable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB,EAAE,MAAc;IAC7D,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAEjD,OAAO,GAAG,IAAI,QAAQ,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,MAAM,WAAW,GAA2B;QAC1C,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,EAAE,GAAG,IAAI;QACZ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;QACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;KACvB,CAAC;IAEF,OAAO,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/types/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Shared configuration types.
+ * Spec: §2.2 — Shared Configuration
+ */
+export interface PollingConfig {
+    /** Message + agent status polling when idle (seconds) */
+    idleIntervalSeconds: number;
+    /** Agent heartbeat write interval (seconds) */
+    heartbeatIntervalSeconds: number;
+    /** Heartbeat staleness threshold = dead agent (seconds) */
+    stuckThresholdSeconds: number;
+}
+export interface ParentLivenessConfig {
+    /** Prompt before orphaning children on shutdown */
+    shutdownGuard: boolean;
+    /** Children detect dead parents and shut down */
+    childSelfRescue: boolean;
+    /** Finish current task before shutting down (seconds) */
+    orphanGracePeriodSeconds: number;
+}
+/**
+ * Cross-cutting settings shared by multiple extensions.
+ * Spec: §2.2
+ */
+export interface OrcaConfig {
+    polling: PollingConfig;
+    parentLiveness: ParentLivenessConfig;
+}
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_CONFIG: OrcaConfig;
+/**
+ * Merge user and project configs (project overrides user).
+ * Spec: §2.2
+ *
+ * @param userConfig - User-level config
+ * @param projectConfig - Project-level config (optional)
+ * @returns Merged configuration
+ */
+export declare function mergeConfig(userConfig: Partial<OrcaConfig>, projectConfig?: Partial<OrcaConfig>): OrcaConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,wBAAwB,EAAE,MAAM,CAAC;IACjC,2DAA2D;IAC3D,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,CAAC;IACvB,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAW5B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,EAC/B,aAAa,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAClC,UAAU,CAaZ"}

package/dist/types/config.js

@@ -0,0 +1,42 @@
+/**
+ * Shared configuration types.
+ * Spec: §2.2 — Shared Configuration
+ */
+/**
+ * Default configuration values.
+ */
+export const DEFAULT_CONFIG = {
+    polling: {
+        idleIntervalSeconds: 30,
+        heartbeatIntervalSeconds: 30,
+        stuckThresholdSeconds: 120,
+    },
+    parentLiveness: {
+        shutdownGuard: true,
+        childSelfRescue: true,
+        orphanGracePeriodSeconds: 60,
+    },
+};
+/**
+ * Merge user and project configs (project overrides user).
+ * Spec: §2.2
+ *
+ * @param userConfig - User-level config
+ * @param projectConfig - Project-level config (optional)
+ * @returns Merged configuration
+ */
+export function mergeConfig(userConfig, projectConfig) {
+    return {
+        polling: {
+            ...DEFAULT_CONFIG.polling,
+            ...userConfig.polling,
+            ...projectConfig?.polling,
+        },
+        parentLiveness: {
+            ...DEFAULT_CONFIG.parentLiveness,
+            ...userConfig.parentLiveness,
+            ...projectConfig?.parentLiveness,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6BH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,OAAO,EAAE;QACP,mBAAmB,EAAE,EAAE;QACvB,wBAAwB,EAAE,EAAE;QAC5B,qBAAqB,EAAE,GAAG;KAC3B;IACD,cAAc,EAAE;QACd,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,wBAAwB,EAAE,EAAE;KAC7B;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,UAA+B,EAC/B,aAAmC;IAEnC,OAAO;QACL,OAAO,EAAE;YACP,GAAG,cAAc,CAAC,OAAO;YACzB,GAAG,UAAU,CAAC,OAAO;YACrB,GAAG,aAAa,EAAE,OAAO;SAC1B;QACD,cAAc,EAAE;YACd,GAAG,cAAc,CAAC,cAAc;YAChC,GAAG,UAAU,CAAC,cAAc;YAC5B,GAAG,aAAa,EAAE,cAAc;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Pi Orca Core Types
+ */
+export * from "./labels.js";
+export * from "./archivable.js";
+export * from "./config.js";
+export * from "./task.js";
+export * from "./agent.js";
+export * from "./message.js";
+export * from "./team.js";
+export * from "./lock.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,12 @@
+/**
+ * Pi Orca Core Types
+ */
+export * from "./labels.js";
+export * from "./archivable.js";
+export * from "./config.js";
+export * from "./task.js";
+export * from "./agent.js";
+export * from "./message.js";
+export * from "./team.js";
+export * from "./lock.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/types/labels.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Label types and filtering for Pi Orca entities.
+ * Spec: §2.3 — Labels and Tags
+ */
+/**
+ * Labels are arbitrary key-value pairs attached to entities.
+ */
+export type Labels = Record<string, string>;
+/**
+ * Special filter values for matching absent or empty labels.
+ */
+export declare const LABEL_UNSET = "_unset";
+export declare const LABEL_EMPTY = "_empty";
+export declare const LABEL_BLANK = "_blank";
+/**
+ * Label filter with support for special matching values.
+ */
+export type LabelFilter = Record<string, string>;
+/**
+ * Check if entity labels match the filter (conjunctive AND).
+ * Spec: §2.3
+ *
+ * @param entityLabels - Labels attached to the entity
+ * @param filter - Label filter to match against
+ * @returns true if all filter labels match
+ */
+export declare function matchLabels(entityLabels: Labels, filter: LabelFilter): boolean;
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/types/labels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CA0B9E"}

package/dist/types/labels.js

@@ -0,0 +1,45 @@
+/**
+ * Label types and filtering for Pi Orca entities.
+ * Spec: §2.3 — Labels and Tags
+ */
+/**
+ * Special filter values for matching absent or empty labels.
+ */
+export const LABEL_UNSET = "_unset"; // Label key is not present
+export const LABEL_EMPTY = "_empty"; // Label key is present but empty string
+export const LABEL_BLANK = "_blank"; // Either not present OR empty string
+/**
+ * Check if entity labels match the filter (conjunctive AND).
+ * Spec: §2.3
+ *
+ * @param entityLabels - Labels attached to the entity
+ * @param filter - Label filter to match against
+ * @returns true if all filter labels match
+ */
+export function matchLabels(entityLabels, filter) {
+    for (const [key, filterValue] of Object.entries(filter)) {
+        const entityValue = entityLabels[key];
+        const isPresent = key in entityLabels;
+        // Handle special filter values
+        if (filterValue === LABEL_UNSET) {
+            if (isPresent)
+                return false;
+            continue;
+        }
+        if (filterValue === LABEL_EMPTY) {
+            if (!isPresent || entityValue !== "")
+                return false;
+            continue;
+        }
+        if (filterValue === LABEL_BLANK) {
+            if (isPresent && entityValue !== "")
+                return false;
+            continue;
+        }
+        // Exact match required
+        if (entityValue !== filterValue)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=labels.js.map

package/dist/types/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../src/types/labels.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,2BAA2B;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,wCAAwC;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,qCAAqC;AAO1E;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,MAAmB;IACnE,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,GAAG,IAAI,YAAY,CAAC;QAEtC,+BAA+B;QAC/B,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,SAAS;gBAAE,OAAO,KAAK,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,IAAI,WAAW,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAC;YACnD,SAAS;QACX,CAAC;QAED,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,SAAS,IAAI,WAAW,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAC;YAClD,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,IAAI,WAAW,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}