instar 0.28.83 → 0.28.84

package/dist/tasks/task-flow-types.js

@@ -0,0 +1,128 @@
+/**
+ * TaskFlow — types and constants.
+ *
+ * Imported from OpenClaw's task-flow-registry shape, trimmed for Instar v1
+ * (single-writer; managed-only; no `blocked` status).
+ *
+ * See docs/specs/OPENCLAW-IMPORT-TASKFLOW-SPEC.md for full design.
+ */
+import { z } from 'zod';
+export const TERMINAL_STATUSES = new Set([
+    'succeeded',
+    'failed',
+    'cancelled',
+    'lost',
+]);
+// ---------- size limits ----------
+export const MAX_OWNER_KEY_CHARS = 256;
+export const MAX_GOAL_CHARS = 1024;
+export const MAX_CURRENT_STEP_CHARS = 128;
+export const MAX_STATE_JSON_BYTES = 64 * 1024;
+export const MAX_WAIT_JSON_BYTES = 8 * 1024;
+// ---------- defaults ----------
+export const DEFAULT_THRESHOLDS = {
+    RUNNING_LOST_MS: 6 * 60 * 60 * 1000, // 6h
+    REPLY_LOST_MS: 7 * 24 * 60 * 60 * 1000, // 7d
+    HUMAN_REVIEW_LOST_MS: 30 * 24 * 60 * 60 * 1000, // 30d
+    EXTERNAL_LOST_MS: 7 * 24 * 60 * 60 * 1000, // 7d
+    EXTERNAL_GRACE_MS: 60 * 60 * 1000, // 1h
+    XAGENT_LOST_MS: 7 * 24 * 60 * 60 * 1000, // 7d
+};
+export const HEARTBEAT_INTERVAL_MS = 60 * 1000;
+export const SWEEPER_INTERVAL_MS = 60 * 60 * 1000; // hourly
+export const DUE_WAKER_INTERVAL_MS = 60 * 1000; // every minute
+export const MAX_CACHE_ENTRIES = 1000;
+export const MAX_BUSY_RETRIES = 5;
+export const BUSY_BASE_DELAY_MS = 50;
+export const BUSY_CAP_DELAY_MS = 5000;
+export const RESERVED_MAINTENANCE_CONTROLLER = 'TaskFlowMaintenance';
+// ---------- Phase 5: rate limits + cache cap defaults ----------
+// Spec § Threat Model lines 679, 685; § Phase 5 line 650-653.
+export const DEFAULT_CREATE_PER_SEC_PER_CONTROLLER = 10;
+export const DEFAULT_MAX_ACTIVE_PER_CONTROLLER = 50;
+export const DEFAULT_PING_PER_MIN_PER_FLOW = 60;
+export const DEFAULT_CACHE_MAX_ENTRIES = MAX_CACHE_ENTRIES;
+export const DEFAULT_RATE_LIMITS = {
+    createPerSecPerController: DEFAULT_CREATE_PER_SEC_PER_CONTROLLER,
+    maxActivePerController: DEFAULT_MAX_ACTIVE_PER_CONTROLLER,
+    pingPerMinPerFlow: DEFAULT_PING_PER_MIN_PER_FLOW,
+};
+export const DEFAULT_CACHE_CONFIG = {
+    maxEntries: DEFAULT_CACHE_MAX_ENTRIES,
+};
+/** Active (non-terminal) flow statuses for max-active-per-controller bookkeeping. */
+export const ACTIVE_STATUSES = ['queued', 'running', 'waiting'];
+export class TaskFlowError extends Error {
+    code;
+    detail;
+    constructor(code, message, detail = {}) {
+        super(message);
+        this.name = 'TaskFlowError';
+        this.code = code;
+        this.detail = detail;
+    }
+}
+// ---------- zod schemas ----------
+const requesterOriginSchema = z.object({
+    kind: z.enum(['user', 'agent', 'system', 'job']),
+    id: z.string().min(1).max(256),
+    channel: z.string().max(256).optional(),
+});
+const notifyPolicySchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('silent') }),
+    z.object({ kind: z.literal('on-wait'), topicId: z.number().int() }),
+    z.object({ kind: z.literal('on-terminal'), topicId: z.number().int() }),
+    z.object({ kind: z.literal('on-wait-and-terminal'), topicId: z.number().int() }),
+]);
+export const waitJsonSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('reply'),
+        channel: z.string().min(1).max(256),
+        threadId: z.string().min(1).max(256),
+        peer: z.string().min(1).max(256),
+    }),
+    z.object({
+        kind: z.literal('human-review'),
+        question: z.string().min(1).max(2000),
+        topicId: z.number().int().optional(),
+        reviewerId: z.string().max(256).optional(),
+    }),
+    z.object({
+        kind: z.literal('external-call'),
+        serviceId: z.string().min(1).max(256),
+        correlationId: z.string().min(16).max(256),
+        deadline: z.number().int().optional(),
+    }),
+    z.object({
+        kind: z.literal('scheduled-tick'),
+        dueAt: z.number().int(),
+        jobSlug: z.string().max(256).optional(),
+    }),
+    z.object({
+        kind: z.literal('cross-agent-callback'),
+        threadId: z.string().min(1).max(256),
+        correlationId: z.string().min(16).max(256),
+        expectedAgentId: z.string().min(1).max(256),
+    }),
+]);
+export const createFlowInputSchema = z.object({
+    ownerKey: z.string().min(1).max(MAX_OWNER_KEY_CHARS),
+    controllerId: z.string().min(1).max(256),
+    controllerInstanceId: z.string().min(1).max(256),
+    idempotencyKey: z.string().min(8).max(256),
+    goal: z.string().min(1).max(MAX_GOAL_CHARS),
+    currentStep: z.string().max(MAX_CURRENT_STEP_CHARS).optional(),
+    stateJson: z.unknown().optional(),
+    notifyPolicy: notifyPolicySchema.optional(),
+    requesterOrigin: requesterOriginSchema.optional(),
+    privacyScope: z.enum(['private', 'shared-topic', 'shared-project']).optional(),
+});
+export function jsonByteLength(value) {
+    if (value === undefined)
+        return 0;
+    return Buffer.byteLength(JSON.stringify(value), 'utf8');
+}
+export function isTerminalStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}
+//# sourceMappingURL=task-flow-types.js.map

package/dist/tasks/task-flow-types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.28.83",
+  "version": "0.28.84",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",