@chipschat/protocol 0.0.0-stage → 1.0.0

package/dist/primitives.d.ts

@@ -0,0 +1,194 @@
+/**
+ * The sub-schemas events are built from. Each one exists because more than one event needs
+ * it, and each carries a description, because those descriptions become the documentation
+ * reference (technical-plan decision 13).
+ */
+import { z } from "zod";
+import { type IdKind } from "./ids/index.js";
+/** A schema for one kind of prefixed ULID, for example `run_01K4...` (decision 11). */
+export declare function id<K extends IdKind>(kind: K): z.ZodString;
+export declare const isoTimestamp: z.ZodISODateTime;
+/** Who caused an event. Every envelope says so; the audit log is a read of this field. */
+export declare const actor: z.ZodObject<{
+    kind: z.ZodEnum<{
+        person: "person";
+        agent: "agent";
+        system: "system";
+    }>;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type Actor = z.infer<typeof actor>;
+/** A person or agent as another party sees them, with the role Chips assigns. */
+export declare const participantRef: z.ZodObject<{
+    participant_id: z.ZodString;
+    kind: z.ZodEnum<{
+        person: "person";
+        agent: "agent";
+    }>;
+    display_name: z.ZodString;
+    role: z.ZodEnum<{
+        owner: "owner";
+        member: "member";
+        guest: "guest";
+    }>;
+}, z.core.$strip>;
+export type ParticipantRef = z.infer<typeof participantRef>;
+/**
+ * An attachment. Anything you can send a person you can send an agent, so this shape carries
+ * files, images, video and voice notes alike (decision 10).
+ */
+export declare const attachment: z.ZodObject<{
+    attachment_id: z.ZodString;
+    filename: z.ZodString;
+    mime_type: z.ZodString;
+    byte_size: z.ZodInt;
+    sha256: z.ZodString;
+    width: z.ZodOptional<z.ZodInt>;
+    height: z.ZodOptional<z.ZodInt>;
+    duration_ms: z.ZodOptional<z.ZodInt>;
+}, z.core.$strip>;
+export type Attachment = z.infer<typeof attachment>;
+/** An attachment as it reaches an agent: with a URL it can actually fetch. */
+export declare const signedAttachment: z.ZodObject<{
+    attachment_id: z.ZodString;
+    filename: z.ZodString;
+    mime_type: z.ZodString;
+    byte_size: z.ZodInt;
+    sha256: z.ZodString;
+    width: z.ZodOptional<z.ZodInt>;
+    height: z.ZodOptional<z.ZodInt>;
+    duration_ms: z.ZodOptional<z.ZodInt>;
+    url: z.ZodURL;
+    url_expires_at: z.ZodISODateTime;
+}, z.core.$strip>;
+export type SignedAttachment = z.infer<typeof signedAttachment>;
+/** Where a claim came from. External sources are what make an action risky. */
+export declare const source: z.ZodObject<{
+    kind: z.ZodEnum<{
+        external: "external";
+        internal: "internal";
+    }>;
+    label: z.ZodString;
+    url: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+export type Source = z.infer<typeof source>;
+/**
+ * Risk classes. These are the flags the policy engine matches on (decision 8), so the list is
+ * closed: a new class is a protocol change, not a free-text string an agent invents.
+ */
+export declare const riskClass: z.ZodEnum<{
+    external: "external";
+    external_communication: "external_communication";
+    irreversible: "irreversible";
+    destructive: "destructive";
+    financial: "financial";
+    credential: "credential";
+    privacy: "privacy";
+    legal: "legal";
+}>;
+export type RiskClass = z.infer<typeof riskClass>;
+/** The action an agent wants to take. `kind` is what policy rules glob against. */
+export declare const action: z.ZodObject<{
+    kind: z.ZodString;
+    input: z.ZodOptional<z.ZodUnknown>;
+    external: z.ZodOptional<z.ZodBoolean>;
+    irreversible: z.ZodOptional<z.ZodBoolean>;
+    money_usd: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Action = z.infer<typeof action>;
+/** What a person is shown before they decide. A diff for a change, prose for a message. */
+export declare const preview: z.ZodObject<{
+    format: z.ZodEnum<{
+        markdown: "markdown";
+        plain: "plain";
+        diff: "diff";
+        json: "json";
+        table: "table";
+    }>;
+    body: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Preview = z.infer<typeof preview>;
+/**
+ * Who may answer an approval. `owner` and `role:<name>` are resolved by Chips, so a harness
+ * never needs to know who is on shift.
+ */
+export declare const approverRef: z.ZodString;
+/** Autonomy levels L0 to L3 (blueprint: trust is a dial, not a switch). */
+export declare const autonomyLevel: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+export type AutonomyLevel = z.infer<typeof autonomyLevel>;
+/** One policy rule. Rules read like sentences: `email.send to an external domain -> ask the owner`. */
+export declare const policyRule: z.ZodObject<{
+    match: z.ZodString;
+    when: z.ZodOptional<z.ZodObject<{
+        external: z.ZodOptional<z.ZodBoolean>;
+        irreversible: z.ZodOptional<z.ZodBoolean>;
+        money_usd_over: z.ZodOptional<z.ZodNumber>;
+        risk: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            external: "external";
+            external_communication: "external_communication";
+            irreversible: "irreversible";
+            destructive: "destructive";
+            financial: "financial";
+            credential: "credential";
+            privacy: "privacy";
+            legal: "legal";
+        }>>>;
+    }, z.core.$strip>>;
+    decision: z.ZodEnum<{
+        allow: "allow";
+        ask: "ask";
+        deny: "deny";
+    }>;
+    approvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PolicyRule = z.infer<typeof policyRule>;
+export declare const policy: z.ZodObject<{
+    autonomy: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+    rules: z.ZodArray<z.ZodObject<{
+        match: z.ZodString;
+        when: z.ZodOptional<z.ZodObject<{
+            external: z.ZodOptional<z.ZodBoolean>;
+            irreversible: z.ZodOptional<z.ZodBoolean>;
+            money_usd_over: z.ZodOptional<z.ZodNumber>;
+            risk: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                external: "external";
+                external_communication: "external_communication";
+                irreversible: "irreversible";
+                destructive: "destructive";
+                financial: "financial";
+                credential: "credential";
+                privacy: "privacy";
+                legal: "legal";
+            }>>>;
+        }, z.core.$strip>>;
+        decision: z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+            deny: "deny";
+        }>;
+        approvers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Policy = z.infer<typeof policy>;
+/** Money is always an estimate and always labelled as one (blueprint: cost rolls up the trail). */
+export declare const cost: z.ZodObject<{
+    usd: z.ZodNumber;
+    estimated: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type Cost = z.infer<typeof cost>;
+export declare const budget: z.ZodObject<{
+    limit_usd: z.ZodNumber;
+    spent_usd: z.ZodNumber;
+}, z.core.$strip>;
+export type Budget = z.infer<typeof budget>;
+/** How work travelled to get here, so a lane can be traced back to the message that caused it. */
+export declare const trailEntry: z.ZodObject<{
+    participant_id: z.ZodString;
+    run_id: z.ZodOptional<z.ZodString>;
+    goal: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TrailEntry = z.infer<typeof trailEntry>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI1D,uFAAuF;AACvF,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,eAK3C;AAED,eAAO,MAAM,YAAY,kBAEoD,CAAC;AAE9E,0FAA0F;AAC1F,eAAO,MAAM,KAAK;;;;;;;iBAOuC,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,iFAAiF;AACjF,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAW8B,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;iBAkBoB,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAKoC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,+EAA+E;AAC/E,eAAO,MAAM,MAAM;;;;;;;iBAU+D,CAAC;AACnF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;EAWiD,CAAC;AACxE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,MAAM;;;;;;iBAcgC,CAAC;AACpD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,2FAA2F;AAC3F,eAAO,MAAM,OAAO;;;;;;;;;;iBAQkC,CAAC;AACvD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,WAAW,aAG8C,CAAC;AAEvE,2EAA2E;AAC3E,eAAO,MAAM,aAAa,2FAIvB,CAAC;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,uGAAuG;AACvG,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;iBA4B2B,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ6D,CAAC;AACjF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,mGAAmG;AACnG,eAAO,MAAM,IAAI;;;iBAKgB,CAAC;AAClC,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,MAAM;;;iBAK0D,CAAC;AAC9E,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,kGAAkG;AAClG,eAAO,MAAM,UAAU;;;;iBAMmC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/primitives.js

@@ -0,0 +1,193 @@
+/**
+ * The sub-schemas events are built from. Each one exists because more than one event needs
+ * it, and each carries a description, because those descriptions become the documentation
+ * reference (technical-plan decision 13).
+ */
+import { z } from "zod";
+import { ID_PREFIXES } from "./ids/index.js";
+const ULID = "[0-7][0-9A-HJKMNP-TV-Z]{25}";
+/** A schema for one kind of prefixed ULID, for example `run_01K4...` (decision 11). */
+export function id(kind) {
+    return z
+        .string()
+        .regex(new RegExp(`^${ID_PREFIXES[kind]}_${ULID}$`), `expected a ${kind} id`)
+        .describe(`A ${kind} identifier: \`${ID_PREFIXES[kind]}_\` followed by a ULID.`);
+}
+export const isoTimestamp = z.iso
+    .datetime({ offset: true })
+    .describe("An ISO 8601 timestamp, for example `2026-09-02T14:22:31.004Z`.");
+/** Who caused an event. Every envelope says so; the audit log is a read of this field. */
+export const actor = z
+    .object({
+    kind: z
+        .enum(["person", "agent", "system"])
+        .describe("Whether a person, an agent or Chips itself acted."),
+    id: z.string().min(1).describe("The participant id, or `system` for Chips."),
+})
+    .describe("The participant an event is attributed to.");
+/** A person or agent as another party sees them, with the role Chips assigns. */
+export const participantRef = z
+    .object({
+    participant_id: z.string().min(1).describe("The stable id of the sender."),
+    kind: z.enum(["person", "agent"]).describe("Whether the sender is a person or an agent."),
+    display_name: z.string().min(1).max(120).describe("The name to show."),
+    role: z
+        .enum(["owner", "member", "guest"])
+        .describe("The sender's standing in this conversation. Multi-user is Chips' job, not the harness's."),
+})
+    .describe("A sender, as the receiving side sees them.");
+/**
+ * An attachment. Anything you can send a person you can send an agent, so this shape carries
+ * files, images, video and voice notes alike (decision 10).
+ */
+export const attachment = z
+    .object({
+    attachment_id: id("attachment"),
+    filename: z.string().min(1).max(255).describe("The name to show. Never trusted for its type."),
+    mime_type: z
+        .string()
+        .min(1)
+        .max(255)
+        .describe("Sniffed from the bytes on upload, not taken from the client."),
+    byte_size: z.int().nonnegative().describe("Size in bytes."),
+    sha256: z
+        .string()
+        .regex(/^[a-f0-9]{64}$/)
+        .describe("Lowercase hex digest. The store is content-addressed."),
+    width: z.int().positive().optional().describe("Pixels, for images and video."),
+    height: z.int().positive().optional().describe("Pixels, for images and video."),
+    duration_ms: z.int().nonnegative().optional().describe("Milliseconds, for audio and video."),
+})
+    .describe("A file carried by a message.");
+/** An attachment as it reaches an agent: with a URL it can actually fetch. */
+export const signedAttachment = attachment
+    .extend({
+    url: z.url().describe("A signed URL, bound to the requesting token."),
+    url_expires_at: isoTimestamp.describe("Ten minutes from issue, by default (decision 10)."),
+})
+    .describe("An attachment with a short-lived, token-bound URL.");
+/** Where a claim came from. External sources are what make an action risky. */
+export const source = z
+    .object({
+    kind: z.enum(["external", "internal"]).describe("Whether the source is outside the workspace."),
+    label: z
+        .string()
+        .min(1)
+        .max(200)
+        .describe("What to show in the receipt, for example `vendor website`."),
+    url: z.url().optional().describe("Where to look, when there is somewhere to look."),
+})
+    .describe("A source an agent used, shown in the receipt and on approval cards.");
+/**
+ * Risk classes. These are the flags the policy engine matches on (decision 8), so the list is
+ * closed: a new class is a protocol change, not a free-text string an agent invents.
+ */
+export const riskClass = z
+    .enum([
+    "external",
+    "external_communication",
+    "irreversible",
+    "destructive",
+    "financial",
+    "credential",
+    "privacy",
+    "legal",
+])
+    .describe("A risk class the policy engine can match a rule against.");
+/** The action an agent wants to take. `kind` is what policy rules glob against. */
+export const action = z
+    .object({
+    kind: z
+        .string()
+        .regex(/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)+$/)
+        .max(120)
+        .describe("A dotted verb, for example `email.send` or `payment.transfer`. Policy rules glob on it."),
+    input: z.unknown().optional().describe("The arguments, shaped by the tool being called."),
+    external: z.boolean().optional().describe("True when the action leaves the workspace."),
+    irreversible: z.boolean().optional().describe("True when the action cannot be undone."),
+    money_usd: z.number().nonnegative().optional().describe("Amount at stake, in US dollars."),
+})
+    .describe("An action an agent proposes to take.");
+/** What a person is shown before they decide. A diff for a change, prose for a message. */
+export const preview = z
+    .object({
+    format: z
+        .enum(["markdown", "plain", "diff", "json", "table"])
+        .describe("How to render the body."),
+    body: z.string().max(200_000).describe("The rendered preview."),
+    title: z.string().max(200).optional().describe("A heading for the card."),
+})
+    .describe("What the approver sees before deciding.");
+/**
+ * Who may answer an approval. `owner` and `role:<name>` are resolved by Chips, so a harness
+ * never needs to know who is on shift.
+ */
+export const approverRef = z
+    .string()
+    .regex(/^(owner|any|role:[a-z][a-z0-9_]*|usr_[0-9A-HJKMNP-TV-Z]{26})$/)
+    .describe("`owner`, `any`, `role:<name>`, or a specific person id.");
+/** Autonomy levels L0 to L3 (blueprint: trust is a dial, not a switch). */
+export const autonomyLevel = z
+    .union([z.literal(0), z.literal(1), z.literal(2), z.literal(3)])
+    .describe("0 observe, 1 ask first, 2 ask when it matters, 3 autonomous and report back. Presets that expand to rules.");
+/** One policy rule. Rules read like sentences: `email.send to an external domain -> ask the owner`. */
+export const policyRule = z
+    .object({
+    match: z
+        .string()
+        .min(1)
+        .max(120)
+        .describe("A glob over action kinds, for example `payment.*`."),
+    when: z
+        .object({
+        external: z.boolean().optional(),
+        irreversible: z.boolean().optional(),
+        money_usd_over: z.number().nonnegative().optional(),
+        risk: z.array(riskClass).max(8).optional(),
+    })
+        .optional()
+        .describe("Extra conditions on the action's flags."),
+    decision: z.enum(["allow", "ask", "deny"]).describe("What to do when the rule matches."),
+    approvers: z
+        .array(approverRef)
+        .max(16)
+        .optional()
+        .describe("Who may answer, when the decision is `ask`."),
+    reason: z
+        .string()
+        .max(400)
+        .optional()
+        .describe("Shown to the agent, and recorded in the audit log."),
+})
+    .describe("A rule the policy engine evaluates.");
+export const policy = z
+    .object({
+    autonomy: autonomyLevel,
+    rules: z
+        .array(policyRule)
+        .max(200)
+        .describe("Evaluated in order; the workspace cap always wins."),
+})
+    .describe("An agent's autonomy level and the rules that fill in the details.");
+/** Money is always an estimate and always labelled as one (blueprint: cost rolls up the trail). */
+export const cost = z
+    .object({
+    usd: z.number().nonnegative().describe("An estimate, in US dollars."),
+    estimated: z.literal(true).describe("Always true. Cost is never presented as exact."),
+})
+    .describe("An estimated cost.");
+export const budget = z
+    .object({
+    limit_usd: z.number().nonnegative().describe("The ceiling for this agent."),
+    spent_usd: z.number().nonnegative().describe("Spent so far, estimated."),
+})
+    .describe("An agent's budget. Warns at 80 percent, pauses the run at 100.");
+/** How work travelled to get here, so a lane can be traced back to the message that caused it. */
+export const trailEntry = z
+    .object({
+    participant_id: z.string().min(1).describe("Who handled this hop."),
+    run_id: id("run").optional().describe("The run this hop belongs to."),
+    goal: z.string().max(2000).optional().describe("What was asked at this hop."),
+})
+    .describe("One hop in the chain that led to this work.");
+//# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAe,MAAM,gBAAgB,CAAC;AAE1D,MAAM,IAAI,GAAG,6BAA6B,CAAC;AAE3C,uFAAuF;AACvF,MAAM,UAAU,EAAE,CAAmB,IAAO;IAC1C,OAAO,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,cAAc,IAAI,KAAK,CAAC;SAC5E,QAAQ,CAAC,KAAK,IAAI,kBAAkB,WAAW,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG;KAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAC1B,QAAQ,CAAC,gEAAgE,CAAC,CAAC;AAE9E,0FAA0F;AAC1F,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;SACnC,QAAQ,CAAC,mDAAmD,CAAC;IAChE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC7E,CAAC;KACD,QAAQ,CAAC,4CAA4C,CAAC,CAAC;AAG1D,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACzF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACtE,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAClC,QAAQ,CACP,0FAA0F,CAC3F;CACJ,CAAC;KACD,QAAQ,CAAC,4CAA4C,CAAC,CAAC;AAG1D;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,aAAa,EAAE,EAAE,CAAC,YAAY,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC9F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC3D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,KAAK,CAAC,gBAAgB,CAAC;SACvB,QAAQ,CAAC,uDAAuD,CAAC;IACpE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC9E,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC/E,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC7F,CAAC;KACD,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAG5C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU;KACvC,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACrE,cAAc,EAAE,YAAY,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAC3F,CAAC;KACD,QAAQ,CAAC,oDAAoD,CAAC,CAAC;AAGlE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC/F,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,4DAA4D,CAAC;IACzE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CACpF,CAAC;KACD,QAAQ,CAAC,qEAAqE,CAAC,CAAC;AAGnF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,IAAI,CAAC;IACJ,UAAU;IACV,wBAAwB;IACxB,cAAc;IACd,aAAa;IACb,WAAW;IACX,YAAY;IACZ,SAAS;IACT,OAAO;CACR,CAAC;KACD,QAAQ,CAAC,0DAA0D,CAAC,CAAC;AAGxE,mFAAmF;AACnF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,uCAAuC,CAAC;SAC9C,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,yFAAyF,CAC1F;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACzF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACvF,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACvF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CAC3F,CAAC;KACD,QAAQ,CAAC,sCAAsC,CAAC,CAAC;AAGpD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC;KACrB,MAAM,CAAC;IACN,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;SACpD,QAAQ,CAAC,yBAAyB,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC1E,CAAC;KACD,QAAQ,CAAC,yCAAyC,CAAC,CAAC;AAGvD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,KAAK,CAAC,+DAA+D,CAAC;KACtE,QAAQ,CAAC,yDAAyD,CAAC,CAAC;AAEvE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;KAC/D,QAAQ,CACP,4GAA4G,CAC7G,CAAC;AAGJ,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,oDAAoD,CAAC;IACjE,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAChC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QACnD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC3C,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACxF,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,WAAW,CAAC;SAClB,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC;KACD,QAAQ,CAAC,qCAAqC,CAAC,CAAC;AAGnD,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,QAAQ,EAAE,aAAa;IACvB,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,UAAU,CAAC;SACjB,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC;KACD,QAAQ,CAAC,mEAAmE,CAAC,CAAC;AAGjF,mGAAmG;AACnG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACrE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACtF,CAAC;KACD,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAGlC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACzE,CAAC;KACD,QAAQ,CAAC,gEAAgE,CAAC,CAAC;AAG9E,kGAAkG;AAClG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACnE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;CAC9E,CAAC;KACD,QAAQ,CAAC,6CAA6C,CAAC,CAAC"}

package/dist/src/address.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Who a message is for (ADR 0081).
+ *
+ * Chips decides, once, at ingest, which agents in a space a message is for, and only they take
+ * a turn on it; the others overhear it. The server that decides, the conformance fake that plays
+ * the server, and the clients that show the answer before a send have to agree, so the rule lives
+ * here, with the schemas, as `mentions.ts` does.
+ *
+ * Who takes a turn is agents only: people read every message. An agent is a harness's (ADR 0087);
+ * a harness still in a room from before agents counts as one until the upgrade gives it one. A
+ * message can be for a person too (ADR 0204): one the sender @s, or picks in the field's list. No
+ * agent takes a turn for them; they are told, as an @ tells them. Natalie's "How's it going?" in
+ * Foodie on 19 October 2026 had no way to be for Arjun, and went to the room's agent.
+ *
+ * An agent's message to agents is held only past the referee's ceiling, or while a person has
+ * paused the agents (ADR 0097, which replaced ADR 0081's hold after four).
+ */
+import { type ExchangeLimits } from "./exchange.js";
+/**
+ * Whether a participant of this kind takes part in rooms as an agent: an agent (ADR 0087), or a
+ * harness in a room from before agents. Anything that is not a person or Chips itself.
+ */
+export declare function isAgentKind(kind: string): boolean;
+export interface AddressInput {
+    /** Who sent it. */
+    readonly sender: {
+        readonly id: string;
+        readonly kind: string;
+    };
+    /** The participants the text's @handles name, as ids, people included. */
+    readonly mentioned: readonly string[];
+    /** Whether the text says `@all`. */
+    readonly everyone: boolean;
+    /** What the sender chose without typing an @: agent ids and people's, or every agent. */
+    readonly to?: readonly string[] | "all" | undefined;
+    /** The author of the message this one answers, when it is a reply. */
+    readonly replyAuthor?: {
+        readonly id: string;
+        readonly kind: string;
+    } | undefined;
+    /** The space's agents that have not been removed, in the order they joined. */
+    readonly agents: readonly string[];
+    /**
+     * The space's people that have not been removed (ADR 0204): who besides its agents an @ or a `to`
+     * can make a message for. Absent, a `to` names agents only, as before.
+     */
+    readonly people?: readonly string[] | undefined;
+    /**
+     * What the sender's previous message in the space was for: its agents, or `all` when it was for
+     * every agent there was. Absent before their first.
+     */
+    readonly last?: readonly string[] | "all" | undefined;
+    /**
+     * How the agents' talk in the space stands (ADR 0097): the messages agents have sent agents
+     * since the last reset, whether a person paused them, and the workspace's limits (ADR 0187),
+     * the defaults where absent. Absent, nothing is held.
+     */
+    readonly exchange?: {
+        readonly count: number;
+        readonly paused: boolean;
+        readonly limits?: ExchangeLimits | undefined;
+    } | undefined;
+}
+export interface Address {
+    /** The agents the message is for. */
+    readonly addressed_to: string[];
+    /**
+     * Set when the message is for every agent in the space, whoever is there: `@all`, a `to` of
+     * `all`, or a person's default of everyone. That person's next message that names nobody goes
+     * to every agent there is then, one added since included.
+     */
+    readonly addressed_to_all?: true;
+    /** Set when Chips held an agent's message (ADR 0097): it is shown, and for nobody. */
+    readonly held?: true;
+    /**
+     * The people a person's message is for (ADR 0204): those its @s name, or else those the sender
+     * picked in `to`. They are told as an @ tells them; no agent takes a turn for them. Absent for
+     * none, and on an agent's message.
+     */
+    readonly addressed_people?: string[];
+}
+/**
+ * The agents a message is for. For a person the first rule that applies decides: an @, the
+ * composer's choice, a reply to an agent, the only agent, then where their last message here
+ * went (every agent before their first). An agent reaches only the agents it names, chose or
+ * answers, and its words are otherwise for the people; past the workspace's hold, or while the
+ * agents are paused, it reaches nobody until a person acts.
+ */
+export declare function resolveAddress(input: AddressInput): Address;
+/**
+ * Who of one connection takes a turn on a message (ADR 0081, ADR 0087): what `message.new`
+ * carries as `for`. The ids the connection answers to among those the message is for: its
+ * agents, and the harness itself where the harness is the member addressed, which it is in a
+ * room asked of it from the + until it claims the room. On a message from before Chips said who
+ * a message is for, every one of the connection's own in the room.
+ *
+ * The harness's own id used to be left out, so the first words in a room asked of a harness
+ * arrived for nobody (`for: []`) and an adapter that read the list as final took no turn (agents
+ * review, finding 31). A `message.new` now always names somebody.
+ *
+ * Never the one who said it (`saidBy`): one of the connection's agents is a turn for another of
+ * them it is for, but not for itself (ADR 0101). Its own words from before Chips said who a
+ * message is for are nobody's turn, as all its own words were before that ADR.
+ */
+export declare function takersOf(addressedTo: readonly string[] | undefined, selves: ReadonlySet<string>, ownInRoom: readonly string[], saidBy?: string): string[];
+//# sourceMappingURL=address.d.ts.map

package/dist/src/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,cAAc,EAAS,MAAM,eAAe,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,SAAS,CAAC;IACpD,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAClF,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GAAG,SAAS,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EACd;QACE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;KAC9C,GACD,SAAS,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;IACjC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CACtC;AAKD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAS3D;AAkFD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC1C,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,EAAE,CAIV"}

package/dist/src/address.js

@@ -0,0 +1,141 @@
+/**
+ * Who a message is for (ADR 0081).
+ *
+ * Chips decides, once, at ingest, which agents in a space a message is for, and only they take
+ * a turn on it; the others overhear it. The server that decides, the conformance fake that plays
+ * the server, and the clients that show the answer before a send have to agree, so the rule lives
+ * here, with the schemas, as `mentions.ts` does.
+ *
+ * Who takes a turn is agents only: people read every message. An agent is a harness's (ADR 0087);
+ * a harness still in a room from before agents counts as one until the upgrade gives it one. A
+ * message can be for a person too (ADR 0204): one the sender @s, or picks in the field's list. No
+ * agent takes a turn for them; they are told, as an @ tells them. Natalie's "How's it going?" in
+ * Foodie on 19 October 2026 had no way to be for Arjun, and went to the room's agent.
+ *
+ * An agent's message to agents is held only past the referee's ceiling, or while a person has
+ * paused the agents (ADR 0097, which replaced ADR 0081's hold after four).
+ */
+import { holds } from "./exchange.js";
+/**
+ * Whether a participant of this kind takes part in rooms as an agent: an agent (ADR 0087), or a
+ * harness in a room from before agents. Anything that is not a person or Chips itself.
+ */
+export function isAgentKind(kind) {
+    return kind !== "person" && kind !== "system";
+}
+/**
+ * The agents a message is for. For a person the first rule that applies decides: an @, the
+ * composer's choice, a reply to an agent, the only agent, then where their last message here
+ * went (every agent before their first). An agent reaches only the agents it names, chose or
+ * answers, and its words are otherwise for the people; past the workspace's hold, or while the
+ * agents are paused, it reaches nobody until a person acts.
+ */
+export function resolveAddress(input) {
+    const members = input.agents.filter((id) => id !== input.sender.id);
+    if (isAgentKind(input.sender.kind)) {
+        const picked = named(input, members) ?? aimed(input, members) ?? answered(input, members);
+        const address = addressOf(picked ?? [], members);
+        const held = input.exchange !== undefined && holds(input.exchange);
+        return address.addressed_to.length > 0 && held ? { addressed_to: [], held: true } : address;
+    }
+    return personAddress(input, members);
+}
+/**
+ * A person's message: an @, the composer's choice, people chosen (who give no agent a turn, ADR
+ * 0204), a reply to an agent, the only agent, then where their last message here went.
+ */
+function personAddress(input, members) {
+    const people = (input.people ?? []).filter((id) => id !== input.sender.id);
+    const chosen = chosenPeople(input, people);
+    const picked = named(input, members) ??
+        aimed(input, members) ??
+        (chosen.length > 0 ? [] : undefined) ??
+        answered(input, members);
+    if (picked !== undefined)
+        return withPeople(addressOf(picked, members), chosen);
+    // A room with no agent yet: the message is for whoever comes, so their next goes to everyone.
+    if (members.length === 0)
+        return addressOf("all", members);
+    if (members.length === 1)
+        return { addressed_to: [...members] };
+    return addressOf(lastOrEveryone(input.last, members), members);
+}
+/**
+ * The people a person's message is for (ADR 0204): those an @ names, when an @ decides, as it
+ * decides for agents; else those the sender picked in `to`. Never the sender.
+ */
+function chosenPeople(input, people) {
+    if (input.everyone)
+        return [];
+    if (input.mentioned.length > 0)
+        return kept(input.mentioned, people);
+    return Array.isArray(input.to) ? kept(input.to, people) : [];
+}
+function withPeople(address, people) {
+    return people.length === 0 ? address : { ...address, addressed_people: [...people] };
+}
+function addressOf(aimed, members) {
+    return aimed === "all"
+        ? { addressed_to: [...members], addressed_to_all: true }
+        : { addressed_to: aimed };
+}
+/** Rule 1: an @ decides, even when it names only people. */
+function named(input, members) {
+    if (input.everyone)
+        return "all";
+    return input.mentioned.length > 0 ? kept(input.mentioned, members) : undefined;
+}
+/** Rule 2: the composer's choice, when it names a member. */
+function aimed(input, members) {
+    if (input.to === undefined)
+        return undefined;
+    if (input.to === "all")
+        return members.length > 0 ? "all" : undefined;
+    const to = kept(input.to, members);
+    return to.length > 0 ? to : undefined;
+}
+/** Rule 3: a reply to an agent that is still here. */
+function answered(input, members) {
+    if (input.replyAuthor === undefined || !isAgentKind(input.replyAuthor.kind))
+        return undefined;
+    const author = kept([input.replyAuthor.id], members);
+    return author.length > 0 ? author : undefined;
+}
+/**
+ * Rule 5: where the sender's last message went. Everyone stays everyone, an agent added since
+ * included. Agents are kept to those still here, and it is everyone before their first message
+ * and when none of those they addressed is left. A last message for no agent (it named only
+ * people) keeps the next one for nobody.
+ */
+function lastOrEveryone(last, members) {
+    if (last === undefined || last === "all")
+        return "all";
+    const still = kept(last, members);
+    return last.length > 0 && still.length === 0 ? "all" : still;
+}
+/** The ids that are members, each once, in the order given. */
+function kept(ids, members) {
+    return [...new Set(ids)].filter((id) => members.includes(id));
+}
+/**
+ * Who of one connection takes a turn on a message (ADR 0081, ADR 0087): what `message.new`
+ * carries as `for`. The ids the connection answers to among those the message is for: its
+ * agents, and the harness itself where the harness is the member addressed, which it is in a
+ * room asked of it from the + until it claims the room. On a message from before Chips said who
+ * a message is for, every one of the connection's own in the room.
+ *
+ * The harness's own id used to be left out, so the first words in a room asked of a harness
+ * arrived for nobody (`for: []`) and an adapter that read the list as final took no turn (agents
+ * review, finding 31). A `message.new` now always names somebody.
+ *
+ * Never the one who said it (`saidBy`): one of the connection's agents is a turn for another of
+ * them it is for, but not for itself (ADR 0101). Its own words from before Chips said who a
+ * message is for are nobody's turn, as all its own words were before that ADR.
+ */
+export function takersOf(addressedTo, selves, ownInRoom, saidBy) {
+    const own = saidBy !== undefined && selves.has(saidBy);
+    if (addressedTo === undefined)
+        return own ? [] : [...ownInRoom];
+    return addressedTo.filter((id) => selves.has(id) && id !== saidBy);
+}
+//# sourceMappingURL=address.js.map