aec-agent 1.0.3 → 1.0.4

package/dist/components/multi-agent-orchestration/agent/job-manager/types.d.ts

@@ -0,0 +1,495 @@
+/** When a job runs on a clock (A-69). */
+export type JobSchedule = 
+/** 5-field cron ("min hour dom month dow"): ranges, steps, lists and names; dom/dow combine with OR like classic cron. */
+{
+    kind: "cron";
+    expr: string; /** IANA timezone, e.g. "Asia/Ho_Chi_Minh". Omitted = the server's timezone. */
+    tz?: string;
+}
+/** Every `ms` milliseconds, counted from the previous scheduled time. */
+ | {
+    kind: "every";
+    ms: number;
+}
+/** Once, at an ISO 8601 time. The job disables itself after it has run. */
+ | {
+    kind: "at";
+    at: string;
+};
+export type JobSignatureScheme = "standard" | "github";
+/**
+ * When a job runs: a schedule, or events from a source.
+ * "event"   — the agent's own SDK events on the event bus (INTERNAL_JOB_EVENT_TYPES).
+ *             In-process: an event emitted while the host is down is not seen.
+ * "webhook" — POSTs to the host's webhook route, signed with the job's secret:
+ *             "standard" = Standard Webhooks (webhook-id / webhook-timestamp / webhook-signature),
+ *             "github"   = X-Hub-Signature-256 + X-GitHub-Delivery + X-GitHub-Event.
+ *             subjectPath / revisionPath pick the subject and revision from the event
+ *             ("data.pull_request.number"); a CloudEvents body sets its own subject.
+ */
+export type JobWhen = JobSchedule | {
+    kind: "event";
+} | {
+    kind: "webhook";
+    signature: JobSignatureScheme;
+    subjectPath?: string;
+    revisionPath?: string;
+};
+export type JobKind = JobWhen["kind"];
+/** True for a job that runs on a clock ("at" / "every" / "cron"). */
+export declare function isScheduleWhen(when: JobWhen): when is JobSchedule;
+/** One declarative condition — no scripts. `path` is "type", "subject", "source" or "data.<dot.path>". */
+export interface JobCondition {
+    path: string;
+    op: "eq" | "neq" | "in" | "exists" | "contains";
+    /** eq/neq: the value; in: an array; exists: true (default) or false; contains: a string or array item. */
+    value?: unknown;
+}
+/** Which events an event or webhook job accepts. Every part that is set must match. A schedule job has none. */
+export interface JobFilter {
+    /** Event types; "prefix.*" matches a prefix. Required for an "event" job. Absent = any type. */
+    types?: string[];
+    /** Only these subjects (e.g. one job's id). */
+    subjects?: string[];
+    where?: JobCondition[];
+}
+/**
+ * Burst coalescing (event and webhook jobs): events for the same job + subject that
+ * arrive before their run starts are handled by one run. The run starts once no new
+ * event came for `quietMs`, at most `maxWaitMs` after the first one, with at most
+ * `maxBatch` events (more open the next run). A schedule job's ticks never coalesce.
+ */
+export interface JobCoalesce {
+    quietMs: number;
+    maxWaitMs: number;
+    maxBatch: number;
+}
+/** Bounds on unattended work. */
+export interface JobLimits {
+    /**
+     * Runs started per rolling hour; more wait for the window. Absent = no limit
+     * (the default for a schedule job: its clock already bounds it).
+     */
+    maxRunsPerHour?: number;
+    /** Runs of this job at once (this process). */
+    maxConcurrentRuns: number;
+    /** Attempts per run, the first included; transient failures retry with backoff. A schedule job defaults to 1. */
+    maxAttempts: number;
+    /** A run is not retried later than this after it was queued. */
+    runDeadlineMs: number;
+    /** Tokens per rolling day; once used up, runs end "blocked". Absent = no budget. */
+    maxTokensPerDay?: number;
+    /** After a run for a subject, the next run for it waits at least this long. */
+    cooldownMs: number;
+    /**
+     * How deep a chain of event jobs may go. An event caused by a run of an event or
+     * webhook job has depth = that run's depth + 1; 0 (default) ignores every event
+     * such a run caused. Events from a schedule job's runs have depth 0.
+     */
+    maxDepth: number;
+    /**
+     * A-103: the longest one attempt may run, in ms (10 s – 24 h). When it passes the run is
+     * aborted and ends "failed" ("Timed out after …"), not retried. Absent (a job stored
+     * before A-103) = DEFAULT_MAX_RUN_MS.
+     */
+    maxRunMs?: number;
+    /**
+     * A-103: after this many finished runs in a row ended "failed" or "blocked", the job
+     * disables itself (0 = never). Succeeded and silent runs reset the streak; suppressed and
+     * stopped runs don't count. Runs from before the job's last edit don't count either, so
+     * re-enabling it starts fresh. Absent (a job stored before A-103) = DEFAULT_PAUSE_AFTER_FAILURES.
+     */
+    pauseAfterFailures?: number;
+}
+/**
+ * "new" — every run gets a fresh session (default).
+ * "reuse" — every run appends to one session, created on the first run (a watcher
+ * that remembers what it already reported).
+ */
+export type JobSessionMode = "new" | "reuse";
+/**
+ * When a job's result is sent to its delivery chat (A-100 phase 3).
+ * "always" — every finished run: the reply, a "no reply" notice, or the error.
+ * "on-output" — only a run that succeeded with a reply.
+ * "on-failure" — only a failed run.
+ * A stopped run is never delivered.
+ * Update (A-126): a silent run (reply [[SILENT]]) is never delivered either.
+ */
+export type JobDeliveryWhen = "always" | "on-output" | "on-failure";
+/**
+ * Where a job's result goes (A-100 phase 3): a chat of one of the agent's channels.
+ * The agent's ChannelManager sends it when the run ends (it listens for the
+ * job events), so the job manager itself never talks to a channel.
+ */
+export interface JobDelivery {
+    /** One of the agent's channels. */
+    channelId: string;
+    /** A chat id on that channel, or "home" for the channel's home chat (/sethome). */
+    target: string;
+    /** With a chat id: the thread inside the chat. */
+    threadId?: string;
+    when: JobDeliveryWhen;
+}
+/**
+ * A-127: where a job asked for in a turn can send its results — the chat app conversation
+ * the turn runs in (absent outside a chat app) and the agent's running channels that have
+ * a home chat.
+ */
+export interface JobDeliveryOptions {
+    /** The chat this turn came from, as "home" when it is its channel's home chat. */
+    here?: JobDelivery;
+    /** The channels with a home chat, by name. */
+    homes: JobHomeChat[];
+}
+/** One channel whose home chat can get job results (A-127). */
+export interface JobHomeChat {
+    channelId: string;
+    /** The channel's name, and its platform ("telegram", "slack"...). */
+    name: string;
+    platform: string;
+}
+/** A delivery to the home chat of each of homes (A-127). */
+export declare function homeJobDeliveries(homes: readonly JobHomeChat[]): JobDelivery[];
+/**
+ * Where a job's results go when the turn names nothing (A-127): back to this chat in a
+ * chat app, else to every home chat. Empty when there is neither.
+ */
+export declare function defaultJobDeliveries(options: JobDeliveryOptions): JobDelivery[];
+/**
+ * When a tool job also starts a model turn after its tool (A-103):
+ * "never" — the tool's output is the result (default);
+ * "on-failure" — only when the tool failed (e.g. "explain the error");
+ * "always" — after every tool run; the turn sees the tool's output in the session.
+ */
+export type JobFollowUp = "never" | "on-failure" | "always";
+/**
+ * What a run does (A-103). Absent on a job = "prompt" (every job stored before A-103).
+ * "prompt" — a full agent turn with the job's prompt (as before).
+ * "tool"   — one stored tool call, run without the model: the exact tool and arguments
+ *            approved when the job was created. Schedule jobs only. The tool must be in
+ *            the agent's tool list and marked ToolDefinition.schedulable.
+ */
+export type JobAction = {
+    kind: "prompt";
+} | {
+    kind: "tool";
+    /** A schedulable tool in the agent's tool list. */
+    tool: string;
+    /** The exact arguments, approved when the job was created; never templated. */
+    args: Record<string, unknown>;
+    /** Default "never". Any other value needs the job's prompt (the follow-up turn's message). */
+    followUp?: JobFollowUp;
+};
+export interface Job {
+    id: string;
+    /** Owning agent. Every read path is filtered by it. */
+    agentId: string;
+    /** Short name, unique per agent. */
+    name: string;
+    description?: string;
+    enabled: boolean;
+    /** Bumped on every configuration change; a run records the version it was queued under. */
+    version: number;
+    when: JobWhen;
+    /** Event and webhook jobs: which events start a run. Empty for a schedule job. */
+    filter: JobFilter;
+    /**
+     * The message the agent receives on each run. It must stand on its own — runs see
+     * no chat history. Event and webhook jobs may use placeholders {{job.name}},
+     * {{event.type}}, {{event.subject}}, {{event.source}}, {{event.time}},
+     * {{events.count}}; event data is never inlined into it, it follows in a block
+     * marked as untrusted.
+     * Update (A-103): every job may also use {{now}}, {{job.lastRunAt}},
+     * {{job.lastSuccessAt}} and {{job.lastResult}} (the previous successful result, attached
+     * in its own block). A tool job's prompt is only the follow-up turn's message, so it may
+     * be empty when the follow-up is "never".
+     */
+    prompt: string;
+    /** A-103: what a run does. Absent = a prompt run (a full agent turn). */
+    action?: JobAction;
+    coalesce: JobCoalesce;
+    limits: JobLimits;
+    sessionMode: JobSessionMode;
+    /** "reuse" mode: the session runs append to (set on the first run). */
+    sessionId?: string;
+    /** Schedule jobs: ISO time of the next run; null when disabled, not on a clock, or a one-off job has run. */
+    nextRunAt: string | null;
+    lastRunAt?: string;
+    lastStatus?: JobRunStatus;
+    lastError?: string;
+    /**
+     * Webhook signing secret ("whsec_" + base64). Generated by the SDK; hosts must
+     * encrypt it at rest and show it only on create / rotate.
+     */
+    secret?: string;
+    /** Who made it — a person (host API/UI) or the agent itself (manage_job tool). */
+    createdBy: "user" | "agent";
+    /** The session the agent was asked in, when createdBy is "agent". */
+    createdInSessionId?: string;
+    /** Send each run's result to a chat (A-100 phase 3). Absent = results stay in the run's session. */
+    /** Update (A-127): to every chat in the list (several channels' home chats, say). Absent or empty = results stay in the run's session. */
+    deliveries?: JobDelivery[];
+    /** ISO timestamps. */
+    createdAt: string;
+    updatedAt: string;
+}
+/** What happened to an incoming event. */
+export type JobEventStatus = 
+/** Matched and queued in a run. */
+"accepted"
+/** Did not match the job's filter (kept so the history shows why). */
+ | "filtered"
+/** Matched but dropped: a chain too deep, the previous run still going... (`reason`). */
+ | "suppressed";
+/**
+ * One event in a job's durable inbox — a CloudEvents-style envelope plus where it
+ * came from. Unique per job + source + sourceEventId: the same source event
+ * delivered twice is one inbox entry, while different jobs each get their own.
+ * A clock tick is an event too (source "schedule", id = the scheduled time), so a
+ * scheduled time runs at most once.
+ */
+export interface JobEvent {
+    id: string;
+    jobId: string;
+    agentId: string;
+    /** "schedule", "aec:jobs", "aec:channels", "webhook", "manual", or a CloudEvents source. */
+    source: string;
+    /** The source's own id for the event (a scheduled time, webhook-id, X-GitHub-Delivery, a run id...). */
+    sourceEventId: string;
+    type: string;
+    /** The entity it is about; events are coalesced per subject. */
+    subject?: string;
+    /** Monotonic revision of the subject; a run for an older revision than one already handled is suppressed. */
+    revision?: number;
+    /** When it happened at the source (ISO). */
+    time: string;
+    /** When the inbox received it (ISO). */
+    receivedAt: string;
+    /** Bounded JSON data — untrusted. */
+    data: unknown;
+    /** Ties together everything this event led to. */
+    correlationId: string;
+    /** The event that caused this one, when known. */
+    causationId?: string;
+    /** The job run whose output caused this event, when it came from one. */
+    originRunId?: string;
+    /** 0 for an outside event, origin run depth + 1 for one caused by an event or webhook job's run. */
+    depth: number;
+    status: JobEventStatus;
+    /** Why it was filtered or suppressed. */
+    reason?: string;
+    /** The run it joined. */
+    runId?: string;
+}
+export type JobRunStatus = 
+/** Open: collecting events until notBefore, then claimable. */
+"pending"
+/** Closed and claimable from notBefore: a retry after a transient failure, or waiting for the rate window. */
+ | "waiting" | "running" | "succeeded" | "failed"
+/** Ended without doing its work: an approval was needed, or the token budget is used up (`reason`). */
+ | "blocked"
+/** Dropped before running: the job was disabled or changed, the revision was stale... (`reason`). */
+ | "suppressed"
+/** Stopped by a person. */
+ | "stopped";
+/**
+ * What started a run.
+ * "schedule" = the job's clock; "catch-up" = its time passed while the host was down;
+ * "manual" = run now; "event" / "webhook" = an event from that source; "test" = a test
+ * event; "replay" = a person replayed another run's events.
+ */
+export type JobRunCause = "schedule" | "catch-up" | "manual" | "event" | "webhook" | "test" | "replay";
+/**
+ * One logical run — the unit of work, retries and history. Several coalesced
+ * events share one run. Retries re-run the same logical run (same id and
+ * session); a result checkpoint (resultAt) means the reasoning is done and a
+ * reclaim only finishes recording it.
+ */
+export interface JobRun {
+    id: string;
+    jobId: string;
+    agentId: string;
+    /** Job version when the run was queued. */
+    jobVersion: number;
+    cause: JobRunCause;
+    /** The coalescing bucket: the subject, or "" when events have none. */
+    bucketKey: string;
+    status: JobRunStatus;
+    /** The inbox events this run handles, oldest first. */
+    eventIds: string[];
+    /** Newest revision among the events. */
+    revision?: number;
+    correlationId: string;
+    /** Depth of the run's events (the deepest). */
+    depth: number;
+    /** Claimable from (ISO). */
+    notBefore: string;
+    /** Collecting ends (ISO): the quiet window never pushes notBefore past it. */
+    deadline: string;
+    /** No retry is scheduled after this (ISO). */
+    expiresAt: string;
+    attempts: number;
+    maxAttempts: number;
+    /** The worker holding the run, while it runs. */
+    leaseOwner?: string;
+    leaseUntil?: string;
+    /** The session the run writes into (created on the first attempt, kept for retries). */
+    sessionId?: string;
+    /** Result checkpoint: when the agent's turn finished (ISO). */
+    resultAt?: string;
+    /** The agent's reply. */
+    output?: string;
+    /** The reply was [[SILENT]]: nothing to report, so nothing is delivered. */
+    silent?: boolean;
+    /** A-103: what the run did ("tool": a tool job's stored call). Absent = a prompt run. */
+    action?: "prompt" | "tool";
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** A-88 stop reason of the turn ("max_tokens" / "error"), when it was not a normal finish. */
+    stopReason?: string;
+    error?: string;
+    /** Why it was blocked or suppressed. */
+    reason?: string;
+    /** In-app delivery: when the result was recorded where people read it (ISO). Separate from the run status. */
+    deliveredAt?: string;
+    /** Set on a run made by replaying another run's events. */
+    replayOf?: string;
+    /** ISO timestamps. */
+    createdAt: string;
+    startedAt?: string;
+    finishedAt?: string;
+    updatedAt: string;
+}
+/** Fields a caller may set when creating a job. Omitted coalescing / limits use the defaults for its kind. */
+export interface CreateJobInput {
+    name: string;
+    description?: string;
+    when: JobWhen;
+    filter?: JobFilter;
+    prompt: string;
+    /** Default true. */
+    enabled?: boolean;
+    /** Default "new". */
+    sessionMode?: JobSessionMode;
+    coalesce?: Partial<JobCoalesce>;
+    limits?: Partial<JobLimits>;
+    /** Default "user". The manage_job tool sets "agent". */
+    createdBy?: "user" | "agent";
+    createdInSessionId?: string;
+    /** Default none. */
+    /** Update (A-127): a list. */
+    deliveries?: JobDelivery[];
+    /** A-103: default a prompt run. */
+    action?: JobAction;
+}
+/**
+ * Fields a caller may change. Any change bumps the version. A changed schedule or a
+ * re-enable recomputes nextRunAt (counted from now — no catch-up for the time it was off).
+ */
+export type UpdateJobInput = Partial<Pick<Job, "name" | "description" | "enabled" | "when" | "filter" | "prompt" | "sessionMode">> & {
+    coalesce?: Partial<JobCoalesce>;
+    limits?: Partial<JobLimits>;
+    /** `null` removes the delivery. */
+    /** Update (A-127): replaces the deliveries; `null` or `[]` removes them all. */
+    deliveries?: JobDelivery[] | null;
+    /** A-103: `null` (or { kind: "prompt" }) turns a tool job back into a prompt job. */
+    action?: JobAction | null;
+};
+/** A test event sent by hand (the Jobs page's "Send test event"). */
+export interface JobTestEventInput {
+    type: string;
+    subject?: string;
+    revision?: number;
+    data?: unknown;
+}
+/** What accept() did with an incoming event. */
+export interface JobAcceptResult {
+    /** The source event was already in the inbox; nothing changed. */
+    duplicate: boolean;
+    event: JobEvent;
+    /** The run the event joined, when it was accepted. */
+    run?: JobRun;
+}
+/** An inbound webhook request, passed through by the host. `body` is the raw bytes the signature covers. */
+export interface JobWebhookRequest {
+    method: string;
+    /** Lower-case header names. */
+    headers: Record<string, string | undefined>;
+    body: string | Uint8Array;
+}
+export interface JobWebhookResponse {
+    status: number;
+    body?: unknown;
+}
+/** Handed to the runner for one attempt of a run. */
+export interface JobRunContext {
+    agentId: string;
+    jobId: string;
+    jobName: string;
+    runId: string;
+    cause: JobRunCause;
+    attempt: number;
+    /** The session to run in — already created and owned by the agent. */
+    sessionId: string;
+    /**
+     * The message the agent receives: the job's prompt, plus (event and webhook jobs)
+     * the untrusted event block.
+     */
+    prompt: string;
+    /** Aborted when the run is stopped, the agent is disposed, or the lease is lost. */
+    signal: AbortSignal;
+}
+export interface JobRunResult {
+    /** The agent's reply. */
+    output?: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    /** True when the run was stopped before it finished. */
+    aborted?: boolean;
+    stopReason?: string;
+}
+/**
+ * Runs one agent turn for a job run: `context.prompt` as the user message in
+ * `context.sessionId`. Supplied by the host (AgentCore.useJobRunner) so the turn
+ * takes the host's per-session lock, stop registry, traces and usage. Throwing fails
+ * the attempt; an SDKError with retryable = false is not retried. The runner should
+ * pass `context.sessionId` as RunOptions.sessionId (A-97).
+ */
+export type JobRunner = (context: JobRunContext) => Promise<JobRunResult>;
+/**
+ * An agent's jobs — the API the host routes and the job tools use. Every call is
+ * scoped to the owning agent; an id from another agent is "not found".
+ */
+export interface AgentJobs {
+    list(): Promise<Job[]>;
+    get(id: string): Promise<Job | null>;
+    /** Validates the configuration; throws JobError. A webhook job gets a fresh secret. */
+    create(input: CreateJobInput): Promise<Job>;
+    update(id: string, patch: UpdateJobInput): Promise<Job>;
+    /** Deletes the job, its inbox and run history; stops its runs in progress. */
+    delete(id: string): Promise<void>;
+    /** A new webhook secret; the old one stops working at once. */
+    rotateSecret(id: string): Promise<Job>;
+    /** Queue a run now, outside the schedule (schedule jobs; event and webhook jobs take a test event). */
+    runNow(id: string): Promise<JobRun>;
+    /** Accept a hand-made event (source "manual") through the same filter and inbox (event and webhook jobs). */
+    sendTestEvent(id: string, input: JobTestEventInput): Promise<JobAcceptResult>;
+    /** Verify, parse and accept a webhook delivery. Resolves only after the event is stored. */
+    handleWebhook(id: string, request: JobWebhookRequest): Promise<JobWebhookResponse>;
+    /** Newest received first. */
+    listEvents(id: string, limit?: number): Promise<JobEvent[]>;
+    /** Newest queued first. */
+    listRuns(id: string, limit?: number): Promise<JobRun[]>;
+    getRun(runId: string): Promise<JobRun | null>;
+    /** The inbox events a run handles. */
+    getRunEvents(runId: string): Promise<JobEvent[]>;
+    /** Stop a running or queued run. Returns false when it had already ended. */
+    stopRun(runId: string): Promise<boolean>;
+    /** Queue a new run over the same events (same event ids, replayOf = runId). */
+    replayRun(runId: string): Promise<JobRun>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/multi-agent-orchestration/agent/job-manager/types.d.ts.map

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

package/dist/components/multi-agent-orchestration/agent/job-manager/types.js

@@ -0,0 +1,50 @@
+// ---------------------------------------------------------------------------
+// Jobs (A-126) — one concept for "when X happens, run this prompt, maybe tell me".
+//
+// A Job is a stored prompt plus WHEN it runs:
+//   - on a clock   ("at" / "every" / "cron")  — was a scheduled job (A-69)
+//   - on an event  ("event")                   — the agent's own events, was an event trigger (A-70)
+//   - on a webhook ("webhook")                 — a signed POST from another system, was a webhook trigger (A-70)
+//
+// Every run, whatever started it, goes through one durable path:
+//
+//   clock tick / bus event / webhook / run now / test event
+//        ─► filter ─► durable inbox (dedupe + coalesce) ─► claim/lease ─► agent turn ─► result
+//
+// The JobManager decides WHEN and WHAT; the host decides HOW through a JobRunner,
+// so a run takes the host's per-session lock, stop registry, traces and usage.
+//
+// (from A-70) Durability comes from the store: JobStore.accept() records the event and
+// queues its run in one atomic step, so a host that answers a webhook only after
+// accept() resolves never acknowledges an event it could lose. The in-memory
+// store keeps nothing across a restart.
+//
+// (from A-69) A prompt job is data, not code: it is created by a user (host API/UI)
+// or by the agent itself (manage_job tool), kept in PersistenceHub.jobs and survives a
+// restart. Each run is a real agent turn — model + tools + skills + memory — in a
+// session the user can open later. Code registered by a plugin is a scheduled task
+// (scheduled-task-manager/), not a job.
+// Update (A-126): scheduled tasks (plugin code on a clock) were removed — nothing used
+// them; every scheduled run is a job.
+//
+// Update (A-70 agent tools, kept): the agent may create and change jobs through the
+// manage_job tool, which asks the user for approval on every call (so an unattended run
+// never can). Such a job is marked createdBy "agent", and when it was asked for in a
+// channel chat it delivers its results back there.
+// ---------------------------------------------------------------------------
+/** True for a job that runs on a clock ("at" / "every" / "cron"). */
+export function isScheduleWhen(when) {
+    return when.kind === "cron" || when.kind === "every" || when.kind === "at";
+}
+/** A delivery to the home chat of each of homes (A-127). */
+export function homeJobDeliveries(homes) {
+    return homes.map((h) => ({ channelId: h.channelId, target: "home", when: "always" }));
+}
+/**
+ * Where a job's results go when the turn names nothing (A-127): back to this chat in a
+ * chat app, else to every home chat. Empty when there is neither.
+ */
+export function defaultJobDeliveries(options) {
+    return options.here ? [options.here] : homeJobDeliveries(options.homes);
+}
+//# sourceMappingURL=types.js.map

package/dist/components/multi-agent-orchestration/agent/job-manager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/job-manager/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mFAAmF;AACnF,EAAE;AACF,8CAA8C;AAC9C,2EAA2E;AAC3E,qGAAqG;AACrG,iHAAiH;AACjH,EAAE;AACF,iEAAiE;AACjE,EAAE;AACF,4DAA4D;AAC5D,+FAA+F;AAC/F,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,EAAE;AACF,uFAAuF;AACvF,iFAAiF;AACjF,6EAA6E;AAC7E,wCAAwC;AACxC,EAAE;AACF,oFAAoF;AACpF,uFAAuF;AACvF,kFAAkF;AAClF,mFAAmF;AACnF,wCAAwC;AACxC,uFAAuF;AACvF,sCAAsC;AACtC,EAAE;AACF,oFAAoF;AACpF,wFAAwF;AACxF,qFAAqF;AACrF,mDAAmD;AACnD,8EAA8E;AAkC9E,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;AAC7E,CAAC;AAyHD,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/components/multi-agent-orchestration/agent/job-manager/webhook.d.ts

@@ -0,0 +1,37 @@
+import type { JobWebhookRequest, JobWhen } from "./types.js";
+/** The `when` of a webhook job. */
+type WebhookWhen = Extract<JobWhen, {
+    kind: "webhook";
+}>;
+/** A webhook signature older or newer than this is refused. */
+export declare const WEBHOOK_TOLERANCE_MS: number;
+/** A fresh signing secret: "whsec_" + 32 random bytes in base64. */
+export declare function generateWebhookSecret(): string;
+/** Sign a Standard Webhooks delivery — what a sender does (tests, the docs' example). */
+export declare function signStandardWebhook(secret: string, id: string, timestamp: number, body: string | Uint8Array): string;
+/** Sign a GitHub-style delivery: the X-Hub-Signature-256 value. */
+export declare function signGithubWebhook(secret: string, body: string | Uint8Array): string;
+/** Undefined when the signature is valid, otherwise why it is not. */
+export declare function verifyWebhookSignature(scheme: WebhookWhen["signature"], secret: string, request: JobWebhookRequest, now: number): string | undefined;
+/** What a delivery says about its event — before filtering. */
+export interface WebhookEnvelope {
+    sourceEventId: string;
+    source: string;
+    type: string;
+    subject?: string;
+    revision?: number;
+    /** ISO, when the delivery says. */
+    time?: string;
+    data: unknown;
+}
+/**
+ * The event a verified delivery carries, or an error message. A CloudEvents body
+ * (with "specversion") supplies id, source, type, subject, time and data; a
+ * Standard Webhooks body supplies type, timestamp and data; a GitHub delivery
+ * is its whole body.
+ */
+export declare function parseWebhookEvent(source: WebhookWhen, request: JobWebhookRequest): WebhookEnvelope | {
+    error: string;
+};
+export {};
+//# sourceMappingURL=webhook.d.ts.map

package/dist/components/multi-agent-orchestration/agent/job-manager/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../../../../src/components/multi-agent-orchestration/agent/job-manager/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7D,mCAAmC;AACnC,KAAK,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAqBzD,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAG/C,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAMpH;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAEnF;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAiBpB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,iBAAiB,GACzB,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAyDrC"}