@claudexor/schema 1.0.0

package/dist/thread.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { AuthPreference, FallbackReason, Id, IsoTimestamp, ModeKind, SchemaVersion, } from "./primitives.js";
+import { Attachment } from "./attachment.js";
+/**
+ * Threads / Sessions are the v0.9 chat/session-first SSOT.
+ *
+ * A `Thread` is a Claudexor-owned conversation about a project; runs are "turns"
+ * (moves) inside it. A `Session` is the *vendor* CLI session bound to one harness
+ * for one thread — a re-hostable CACHE, not the source of truth. When a turn
+ * cannot resume the native session in place (isolated-envelope candidates,
+ * race lanes included, or re-hosting onto a different harness) the engine
+ * serializes a `SessionReboundLineage` and emits a typed `session.rebound`
+ * event (honest, lossy disclosure — never silent).
+ */
+/** A thread is open or explicitly closed (archived). "Blocked" is not a thread
+ * state — it is a live projection of whether the head turn's run needs a human. */
+export const ThreadState = z
+    .enum(["active", "closed"])
+    .describe("Thread lifecycle state: active or explicitly closed (archived). Blocked is a live projection, not a thread state.");
+export const SessionState = z
+    .enum(["live", "stale", "rebound"])
+    .describe("Vendor session cache state: live (resumable), stale, or rebound (re-hosted elsewhere).");
+/** How a session can be continued on its native CLI. Staged-field rule:
+ * only values the daemon actually stamps (`resume_by_id` when a native
+ * session id exists, `none` otherwise). */
+export const SessionResumeKind = z
+    .enum(["resume_by_id", "none"])
+    .describe("How the session can be continued on its native CLI: resume_by_id when a native session id exists, none otherwise.");
+export const ThreadTurnKind = z
+    .enum(["initial", "followup", "decision"])
+    .describe("Kind of thread turn: the initial message, a followup, or an operator decision turn.");
+/**
+ * Per-thread workspace mode (v0.10). `in_place` mutates the live project tree
+ * directly (continuity is the tree itself; native vendor sessions resume); the
+ * default, matching how Claude Code / Cursor work locally. `isolated` keeps a
+ * persistent git worktree per thread; turns accumulate there and `apply` merges
+ * into the project. Race candidates always run in throwaway envelopes regardless.
+ */
+export const WorkspaceMode = z
+    .enum(["in_place", "isolated"])
+    .describe("Per-thread workspace mode: in_place mutates the live project tree directly (the default); isolated keeps a persistent git worktree per thread that apply merges into the project.");
+export const ThreadWorkspace = z
+    .object({
+    mode: WorkspaceMode.default("in_place"),
+    /** Set lazily on the first write turn of an isolated thread. */
+    worktree_path: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Persistent worktree path; set lazily on the first write turn of an isolated thread."),
+    /** Snapshot SHA the isolated worktree (or last apply) is based on. */
+    base_sha: z.string().nullable().default(null).describe("Snapshot SHA the isolated worktree (or last apply) is based on."),
+})
+    .describe("How the thread's turns touch files (in-place live tree vs isolated worktree).");
+/** The Claudexor-owned conversation. SSOT for lineage; vendor sessions are caches. */
+export const Thread = z
+    .object({
+    schema_version: SchemaVersion,
+    id: Id.describe("Thread id."),
+    created_at: IsoTimestamp.describe("When the thread was created."),
+    updated_at: IsoTimestamp.describe("When the thread was last updated."),
+    /** Project the thread is anchored to; null for a no-project Ask thread. */
+    repo: z
+        .object({
+        root: z.string().describe("Absolute path of the project root."),
+        base_ref: z.string().describe("Git ref the thread works against."),
+    })
+        .nullable()
+        .default(null)
+        .describe("Project the thread is anchored to; null for a no-project Ask thread."),
+    title: z.string().nullable().default(null).describe("Thread title; null until set."),
+    /** Default mode for new turns; individual turns may override. */
+    mode: ModeKind.default("agent").describe("Default mode for new turns; individual turns may override."),
+    /** Per-thread auth preference override (subscription/api_key/auto). */
+    auth_preference: AuthPreference.default("auto"),
+    /** Sticky orchestrate/primary harness for the thread (re-routable). A bias /
+     * ordering hint, NOT a privileged role — orderPool just pins it first. */
+    primary_harness: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Sticky primary harness for the thread (re-routable); an ordering bias, not a privileged role."),
+    /** Sticky eligible harness pool for the thread (Best-of runs this pool, one
+     * candidate per harness). Empty => the engine auto-pools doctor-ok harnesses.
+     * primary_harness, when set, must be a member of this pool when non-empty. */
+    eligible_harnesses: z
+        .array(z.string())
+        .default([])
+        .describe("Sticky eligible harness pool for the thread (races run one candidate per pool member); empty = the engine auto-pools doctor-ok harnesses."),
+    /** How turns touch files (in-place live tree vs isolated worktree). */
+    workspace: ThreadWorkspace.default({}),
+    /** Ordered run lineage (each run is a turn move). */
+    run_ids: z.array(Id).default([]).describe("Ordered run lineage (each run is a turn move)."),
+    head_run_id: Id.nullable().default(null).describe("Most recent run of the thread; null before the first turn runs."),
+    state: ThreadState.default("active"),
+})
+    .describe("The Claudexor-owned conversation about a project; runs are turns inside it. SSOT for lineage; vendor sessions are caches.");
+/** A re-hostable pointer to one harness's native CLI session for a thread. */
+export const Session = z
+    .object({
+    id: Id.describe("Session id."),
+    thread_id: Id.describe("Thread the session belongs to."),
+    harness_id: Id.describe("Harness the session is bound to."),
+    /** The vendor CLI session id (codex thread id / claude session uuid / ...). */
+    native_session_id: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("The vendor CLI session id (codex thread id / claude session uuid / ...); null when none exists."),
+    resume_kind: SessionResumeKind.default("none"),
+    last_observed_model: z.string().nullable().default(null).describe("Model last observed on the session's stream."),
+    state: SessionState.default("live"),
+    created_at: IsoTimestamp.describe("When the session was created."),
+    updated_at: IsoTimestamp.describe("When the session was last updated."),
+})
+    .describe("A re-hostable pointer to one harness's native CLI session for a thread — a cache, not the source of truth.");
+/**
+ * Well-known machine code for the trust-gate refusal (access=full without the
+ * user-level allow). ONE producer — the engine's trust gate throw — and typed
+ * consumers (the macOS one-click remedy keys on it; never substring matching
+ * on the human message). New gates may attach their own codes without a
+ * schema change: `code` is an open string by design.
+ */
+export const TRUST_FULL_ACCESS_CODE = "trust_full_access_required";
+/**
+ * Typed record of a turn whose run could not be enqueued/started (e.g. the
+ * trust gate refused `access: full`). Persisted ON the turn so every surface
+ * renders the honest refusal inline — a runless turn must never be a silent
+ * orphan whose reason lived only in one HTTP response (INV-093). Cleared when
+ * a retry binds a run.
+ */
+export const TurnEnqueueError = z
+    .object({
+    message: z.string().describe("Human-readable refusal message."),
+    /** Machine-readable refusal code carried from the throwing gate (e.g.
+     * TRUST_FULL_ACCESS_CODE); null when the failure had no typed code. */
+    code: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("Machine-readable refusal code carried from the throwing gate; null when the failure had no typed code."),
+    /** Whether retry can REPLAY this turn: true when a job was recorded before
+     * the failure (the registry holds the params to replay); false when the
+     * enqueue itself threw and no job exists — surfaces then offer "send a new
+     * message" instead of a doomed Retry. */
+    retryable: z
+        .boolean()
+        .default(true)
+        .describe("True when retry can replay this turn (a job was recorded before the failure); false when no job exists to replay."),
+    failed_at: IsoTimestamp.describe("When the enqueue failed."),
+})
+    .describe("Typed record of a turn whose run could not be enqueued/started, persisted on the turn so every surface renders the refusal inline; cleared when a retry binds a run.");
+/** One follow-up unit within a thread (a run is its backing execution). */
+export const ThreadTurn = z
+    .object({
+    id: Id.describe("Turn id."),
+    thread_id: Id.describe("Thread the turn belongs to."),
+    run_id: Id.nullable().default(null).describe("Run backing this turn; null while unbound."),
+    parent_run_id: Id.nullable().default(null).describe("Run this turn follows up on, when any."),
+    /** Set when this turn implements an approved plan from an earlier plan run. */
+    plan_run_id: Id.nullable().default(null).describe("Set when this turn implements an approved plan from an earlier plan run."),
+    kind: ThreadTurnKind.default("followup"),
+    prompt: z.string().default("").describe("The user's message for this turn."),
+    /** Files/images the user attached to this turn (resolved scoped paths). */
+    attachments: z.array(Attachment).default([]).describe("Files/images the user attached to this turn (resolved scoped paths)."),
+    /** Why this turn has no run (enqueue/preflight refusal); null once a run binds. */
+    enqueue_error: TurnEnqueueError.nullable()
+        .default(null)
+        .describe("Why this turn has no run (enqueue/preflight refusal); null once a run binds."),
+    created_at: IsoTimestamp.describe("When the turn was created."),
+})
+    .describe("One follow-up unit within a thread; a run is its backing execution.");
+/**
+ * The lossy payload serialized when a turn cannot resume the native session
+ * in place: isolated-envelope candidates (race lanes included) and re-hosting
+ * onto a different harness (no native memory of the old session). Carried by
+ * the typed `session.rebound` event; the disclosure is explicit, never silent.
+ */
+export const SessionReboundLineage = z
+    .object({
+    thread_id: Id.describe("Thread whose session was re-hosted."),
+    harness_id: Id.describe("Harness the new session runs on."),
+    /** The vendor native session id we are leaving behind (not a Claudexor Id). */
+    from_native_session_id: z
+        .string()
+        .nullable()
+        .default(null)
+        .describe("The vendor native session id being left behind (not a Claudexor id); null when none existed."),
+    to_session_id: Id.nullable().default(null).describe("New Claudexor session id; null when no new session was created."),
+    summary: z.string().default("").describe("Carried-over conversation summary injected into the new session."),
+    reason: FallbackReason.default("not_portable"),
+})
+    .describe("The lossy payload serialized when a turn cannot resume the native session in place (isolated candidates or re-hosting onto a different harness); carried by the session.rebound event.");
+//# sourceMappingURL=thread.js.map

package/dist/thread.js.map

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

package/dist/workproduct.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export declare const WorkProductKind: z.ZodEnum<["patch", "new_repo", "report"]>;
+export type WorkProductKind = z.infer<typeof WorkProductKind>;
+export declare const WorkProduct: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["patch", "new_repo", "report"]>;
+    source_task_id: z.ZodString;
+    producer_attempt_id: z.ZodOptional<z.ZodString>;
+    evidence_dir: z.ZodOptional<z.ZodString>;
+    /** Kind-specific payload (validated loosely here; specialized per kind by callers). */
+    files: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    meta: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "patch" | "new_repo" | "report";
+    files: Record<string, string>;
+    source_task_id: string;
+    meta: Record<string, unknown>;
+    producer_attempt_id?: string | undefined;
+    evidence_dir?: string | undefined;
+}, {
+    id: string;
+    kind: "patch" | "new_repo" | "report";
+    source_task_id: string;
+    files?: Record<string, string> | undefined;
+    producer_attempt_id?: string | undefined;
+    evidence_dir?: string | undefined;
+    meta?: Record<string, unknown> | undefined;
+}>;
+export type WorkProduct = z.infer<typeof WorkProduct>;
+//# sourceMappingURL=workproduct.d.ts.map

package/dist/workproduct.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workproduct.d.ts","sourceRoot":"","sources":["../src/workproduct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe,4CAEwG,CAAC;AACrI,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW;;;;;;IAOpB,uFAAuF;;;;;;;;;;;;;;;;;;;EAOoB,CAAC;AAChH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/workproduct.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { Id } from "./primitives.js";
+// Staged-field rule: the enum ships only kinds runs actually PRODUCE
+// (patch / new_repo / report). Delivery-as-branch/commit/pr is a different,
+// fully-consumed vocabulary (`ControlApplyRequest.mode`) — those values were
+// never work-product kinds with a producer, so they do not live here.
+export const WorkProductKind = z
+    .enum(["patch", "new_repo", "report"])
+    .describe("Kind of work product a run produces: a patch against the base tree, a newly created repository, or a report document.");
+export const WorkProduct = z
+    .object({
+    id: Id.describe("Work product id."),
+    kind: WorkProductKind,
+    source_task_id: Id.describe("Task the work product came from."),
+    producer_attempt_id: Id.optional().describe("Attempt that produced it, when known."),
+    evidence_dir: z.string().optional().describe("Directory holding run evidence artifacts."),
+    /** Kind-specific payload (validated loosely here; specialized per kind by callers). */
+    files: z
+        .record(z.string(), z.string())
+        .default({})
+        .describe("Kind-specific file payload, e.g. artifact name to path (validated loosely here; specialized per kind by callers)."),
+    meta: z.record(z.string(), z.unknown()).default({}).describe("Kind-specific metadata."),
+})
+    .describe("The deliverable a run produced (patch, new repo, or report), referenced by apply/delivery verbs.");
+//# sourceMappingURL=workproduct.js.map

package/dist/workproduct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workproduct.js","sourceRoot":"","sources":["../src/workproduct.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAErC,qEAAqE;AACrE,4EAA4E;AAC5E,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;KACrC,QAAQ,CAAC,uHAAuH,CAAC,CAAC;AAGrI,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACnC,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/D,mBAAmB,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACpF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACzF,uFAAuF;IACvF,KAAK,EAAE,CAAC;SACL,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,mHAAmH,CAAC;IAChI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACxF,CAAC;KACD,QAAQ,CAAC,kGAAkG,CAAC,CAAC"}

package/dist/workspace.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+/**
+ * An isolated execution envelope. A git worktree isolates files; the envelope
+ * additionally isolates env/HOME/harness-config dirs. (Container/
+ * service-sandbox isolation is a future scoped feature, not modeled here.
+ * The dead `env_dir`/`logs_dir`/`artifacts_dir`/`ports` fields — created but
+ * never read anywhere — were deleted per the staged-field rule.)
+ */
+export declare const WorkspaceEnvelope: z.ZodObject<{
+    id: z.ZodString;
+    task_id: z.ZodString;
+    attempt_id: z.ZodString;
+    repo_root: z.ZodString;
+    base_ref: z.ZodString;
+    base_sha: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    worktree_path: z.ZodString;
+    branch_name: z.ZodString;
+    home_dir: z.ZodString;
+    harness_config_dirs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    policy_profile: z.ZodDefault<z.ZodString>;
+    dirty_policy: z.ZodDefault<z.ZodEnum<["refuse", "snapshot"]>>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    worktree_path: string;
+    base_sha: string | null;
+    created_at: string;
+    base_ref: string;
+    task_id: string;
+    attempt_id: string;
+    repo_root: string;
+    dirty_policy: "refuse" | "snapshot";
+    branch_name: string;
+    home_dir: string;
+    harness_config_dirs: Record<string, string>;
+    policy_profile: string;
+}, {
+    id: string;
+    worktree_path: string;
+    created_at: string;
+    base_ref: string;
+    task_id: string;
+    attempt_id: string;
+    repo_root: string;
+    branch_name: string;
+    home_dir: string;
+    base_sha?: string | null | undefined;
+    dirty_policy?: "refuse" | "snapshot" | undefined;
+    harness_config_dirs?: Record<string, string> | undefined;
+    policy_profile?: string | undefined;
+}>;
+export type WorkspaceEnvelope = z.infer<typeof WorkspaceEnvelope>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBwF,CAAC;AACvH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/workspace.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { DirtyPolicy, Id, IsoTimestamp } from "./primitives.js";
+/**
+ * An isolated execution envelope. A git worktree isolates files; the envelope
+ * additionally isolates env/HOME/harness-config dirs. (Container/
+ * service-sandbox isolation is a future scoped feature, not modeled here.
+ * The dead `env_dir`/`logs_dir`/`artifacts_dir`/`ports` fields — created but
+ * never read anywhere — were deleted per the staged-field rule.)
+ */
+export const WorkspaceEnvelope = z
+    .object({
+    id: Id.describe("Envelope id."),
+    task_id: Id.describe("Task the envelope belongs to."),
+    attempt_id: Id.describe("Attempt the envelope belongs to."),
+    repo_root: z.string().describe("Absolute path of the source repository root."),
+    base_ref: z.string().describe("Git ref the worktree was created from."),
+    base_sha: z.string().nullable().default(null).describe("Resolved base commit SHA; null when not recorded."),
+    worktree_path: z.string().describe("Absolute path of the isolated git worktree."),
+    branch_name: z.string().describe("Branch created for the worktree."),
+    home_dir: z.string().describe("Scoped HOME directory for the harness process (kept outside the worktree)."),
+    harness_config_dirs: z
+        .record(z.string(), z.string())
+        .default({})
+        .describe("Scoped per-harness config directories keyed by harness id (kept outside the worktree)."),
+    policy_profile: z.string().default("workspace_write").describe("Access profile the envelope enforces."),
+    dirty_policy: DirtyPolicy.default("refuse"),
+    created_at: IsoTimestamp.describe("When the envelope was created."),
+})
+    .describe("An isolated execution envelope: a git worktree for files plus scoped env/HOME/harness-config isolation.");
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC/B,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACrD,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAC3G,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;IAC3G,mBAAmB,EAAE,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9B,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,wFAAwF,CAAC;IACrG,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACvG,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC3C,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,gCAAgC,CAAC;CACpE,CAAC;KACD,QAAQ,CAAC,yGAAyG,CAAC,CAAC"}