@richhardry/codor 0.10.0

package/node_modules/@codor/protocol/dist/room.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { DeliverySchema } from './delivery.js';
+import { MemberIdSchema, RoomIdSchema, TimestampSchema } from './ids.js';
+import { AssignableHandleSchema, MemberKindSchema } from './member.js';
+import { MessageKindSchema, MessageSchema } from './message.js';
+import { PolicySchema, ThinkingLevelSchema } from './adapter.js';
+// harn:assume brakes-default-off ref=room-config-brakes
+/**
+ * Visibility is always-on; brakes are OPT-IN (PROTOCOL §3). Defaults:
+ * both brakes null (off) — agent→agent chains run until the work is done.
+ * `stall_minutes` is an always-on informational flag (never kills anything);
+ * `redaction_enabled` is the per-room opt-OUT for the redaction projection.
+ */
+export const RoomConfigSchema = z.object({
+    turn_brake: z.number().int().positive().nullable().default(null), // max agent→agent hops
+    spend_brake_usd: z.number().positive().nullable().default(null), // daily cost hold threshold
+    stall_minutes: z.number().int().positive().default(30),
+    redaction_enabled: z.boolean().default(true),
+    // harn:assume channel-create-request-contract ref=channel-room-metadata
+    color: z.string().min(1).optional(),
+    cwd: z.string().min(1).optional(),
+    // harn:assume channel-starting-agent-handle-persisted ref=starting-agent-config-field
+    starting_agent_handle: AssignableHandleSchema.optional(),
+    // harn:end channel-starting-agent-handle-persisted
+    // harn:end channel-create-request-contract
+    // harn:assume bridged-room-wears-banner-v5 ref=bridged-room-config
+    bridged: z.boolean().default(false),
+    // harn:end bridged-room-wears-banner-v5
+});
+// harn:end brakes-default-off
+export const RoomSchema = z.object({
+    id: RoomIdSchema,
+    name: z.string().min(1),
+    created_ts: TimestampSchema,
+    config: RoomConfigSchema.prefault({}),
+});
+// harn:assume room-support-is-bounded-recipient-scoped-state ref=room-support-protocol
+// harn:assume durable-room-summaries-stream-and-fallback ref=durable-room-summary
+export const RoomSummaryLatestSchema = z.object({
+    id: z.number().int().positive(),
+    ts: TimestampSchema,
+    kind: MessageKindSchema,
+    author_handle: z.string(),
+    author_kind: MemberKindSchema,
+    preview: z.string().max(140),
+});
+export const RoomSummarySchema = z.object({
+    id: RoomIdSchema,
+    name: z.string().min(1),
+    created_ts: TimestampSchema,
+    color: z.string().min(1).optional(),
+    working: z.boolean(),
+    attention: z.boolean(),
+    latest: RoomSummaryLatestSchema.optional(),
+    unread: z.number().int().nonnegative(),
+});
+// harn:assume actionable-inbox-clears-on-read-or-reply ref=actionable-inbox-projection
+export const RoomInboxItemSchema = z.object({
+    delivery: DeliverySchema,
+    author_id: MemberIdSchema,
+    author_handle: z.string(),
+    author_kind: MemberKindSchema,
+    message_kind: MessageKindSchema,
+    preview: z.string().max(140),
+    ts: TimestampSchema,
+});
+// harn:end actionable-inbox-clears-on-read-or-reply
+export const RoomSupportSchema = z.object({
+    room: RoomIdSchema,
+    summary: RoomSummarySchema,
+    latest_finalized_agent_id: MemberIdSchema.optional(),
+    active_runs: z.array(MessageSchema),
+    interactions: z.array(MessageSchema),
+    inbox: z.array(RoomInboxItemSchema),
+});
+// harn:end durable-room-summaries-stream-and-fallback
+// harn:end room-support-is-bounded-recipient-scoped-state
+// harn:assume channel-create-request-contract ref=channel-create-request-schema
+export const StartingAgentSchema = z.object({
+    harness: z.string().min(1),
+    handle: AssignableHandleSchema,
+    // harn:assume starting-agent-name-derives-one-valid-identity-v6 ref=starting-agent-identity-contract
+    display_name: z.string().min(1).optional(),
+    // harn:end starting-agent-name-derives-one-valid-identity-v6
+    model: z.string().optional(),
+    thinking: ThinkingLevelSchema.optional(),
+    // harn:assume one-control-chooses-an-agent-everywhere ref=starting-agent-policy
+    // Without this, every channel-seeded agent spawned with NO policy at all — the
+    // create-channel dialog could not express one because the contract had nowhere to
+    // put it. The spawn dialog could. Same agent, same question, two different answers.
+    policy: PolicySchema.optional(),
+    // harn:end one-control-chooses-an-agent-everywhere
+});
+export const CreateRoomRequestSchema = z.object({
+    id: RoomIdSchema.optional(),
+    name: z.string().min(1),
+    owner: z.object({
+        handle: AssignableHandleSchema,
+        display_name: z.string(),
+    }),
+    color: z.string().min(1).optional(),
+    cwd: z.string().min(1).optional(),
+    starting_agent: StartingAgentSchema.optional(),
+});
+// harn:end channel-create-request-contract
+/** Daily per-room spend meter (always on, never blocking). */
+// harn:assume estimated-cost-is-advisory-not-spend-brake-input ref=room-meter-cost-provenance-schema
+export const RoomMeterSchema = z.object({
+    room: RoomIdSchema,
+    day: z.iso.date(), // YYYY-MM-DD, switchboard clock
+    turns: z.number().int().nonnegative(),
+    cost_usd: z.number().nonnegative(), // sums only cost-reporting members
+    estimated_cost_usd: z.number().nonnegative().optional(), // immutable advisory estimates
+    input_tokens: z.number().int().nonnegative(),
+    output_tokens: z.number().int().nonnegative(),
+    uncosted_tokens: z.number().int().nonnegative().optional(),
+});
+// harn:end estimated-cost-is-advisory-not-spend-brake-input
+// harn:assume every-channel-has-a-visible-accent ref=channel-accent-derivation
+/**
+ * The palette a channel's accent is drawn from. F3's root cause was that colour
+ * was a creation-dialog concept: the CLI (and the systemd unit that boot-seeds a
+ * channel through it) created channels with no colour at all, so the rail had
+ * nothing to show. A channel that nobody chose a colour for still gets one.
+ */
+export const CHANNEL_ACCENTS = [
+    '#80c56d',
+    '#67b7c7',
+    '#8c86d7',
+    '#d8b34d',
+    '#d86a64',
+    '#5f8fd3',
+];
+/** Stable in both directions: the same channel always gets the same accent. */
+export function deriveRoomColor(id) {
+    let hash = 0;
+    for (const character of id)
+        hash = (hash * 31 + character.codePointAt(0)) % 1_000_003;
+    return CHANNEL_ACCENTS[hash % CHANNEL_ACCENTS.length];
+}
+// harn:end every-channel-has-a-visible-accent
+//# sourceMappingURL=room.js.map

package/node_modules/@codor/protocol/dist/room.js.map

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