@agentdock/wire 0.4.0

package/dist/interactionEvents.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Interaction event schemas for bidirectional communication.
+ *
+ * Event types: question, permission-request, answer.
+ * RPC params: answer-question, approve-permission, deny-permission.
+ */
+import { z } from 'zod';
+/** Option for structured (multiple-choice) questions. */
+export declare const QuestionOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    description: string;
+}, {
+    label: string;
+    description?: string | undefined;
+}>;
+export type QuestionOption = z.infer<typeof QuestionOptionSchema>;
+/** Agent asks the user a question. */
+export declare const SessionQuestionEventSchema: z.ZodObject<{
+    t: z.ZodLiteral<"question">;
+    requestId: z.ZodString;
+    text: z.ZodString;
+    questionType: z.ZodDefault<z.ZodEnum<["free-text", "yes-no", "single-select", "multi-select"]>>;
+    /** Header/category chip for structured questions. */
+    header: z.ZodOptional<z.ZodString>;
+    /** Options for single-select / multi-select questions. */
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description: string;
+    }, {
+        label: string;
+        description?: string | undefined;
+    }>, "many">>;
+    /** Whether multiple options can be selected. */
+    multiSelect: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    t: "question";
+    requestId: string;
+    text: string;
+    questionType: "free-text" | "yes-no" | "single-select" | "multi-select";
+    options?: {
+        label: string;
+        description: string;
+    }[] | undefined;
+    header?: string | undefined;
+    multiSelect?: boolean | undefined;
+}, {
+    t: "question";
+    requestId: string;
+    text: string;
+    options?: {
+        label: string;
+        description?: string | undefined;
+    }[] | undefined;
+    questionType?: "free-text" | "yes-no" | "single-select" | "multi-select" | undefined;
+    header?: string | undefined;
+    multiSelect?: boolean | undefined;
+}>;
+/** Agent requests tool execution approval. */
+export declare const SessionPermissionRequestEventSchema: z.ZodObject<{
+    t: z.ZodLiteral<"permission-request">;
+    requestId: z.ZodString;
+    toolName: z.ZodString;
+    toolCallId: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    description: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    t: "permission-request";
+    requestId: string;
+    toolName: string;
+    toolCallId: string;
+    args: Record<string, unknown>;
+}, {
+    t: "permission-request";
+    requestId: string;
+    toolName: string;
+    toolCallId: string;
+    args: Record<string, unknown>;
+    description?: string | undefined;
+}>;
+/** User's answer to a question or acknowledgement. */
+export declare const SessionAnswerEventSchema: z.ZodObject<{
+    t: z.ZodLiteral<"answer">;
+    requestId: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    t: "answer";
+    requestId: string;
+    text: string;
+}, {
+    t: "answer";
+    requestId: string;
+    text: string;
+}>;
+/** How a permission was resolved — persisted in envelope stream for history replay. */
+export declare const PermissionActionSchema: z.ZodEnum<["approve", "approve-all-edits", "approve-tool", "deny"]>;
+/** Records the user's decision on a permission request (sent immediately after resolution). */
+export declare const SessionPermissionResolvedEventSchema: z.ZodObject<{
+    t: z.ZodLiteral<"permission-resolved">;
+    requestId: z.ZodString;
+    action: z.ZodEnum<["approve", "approve-all-edits", "approve-tool", "deny"]>;
+}, "strip", z.ZodTypeAny, {
+    t: "permission-resolved";
+    requestId: string;
+    action: "approve" | "approve-all-edits" | "approve-tool" | "deny";
+}, {
+    t: "permission-resolved";
+    requestId: string;
+    action: "approve" | "approve-all-edits" | "approve-tool" | "deny";
+}>;
+export type SessionQuestionEvent = z.infer<typeof SessionQuestionEventSchema>;
+export type SessionPermissionRequestEvent = z.infer<typeof SessionPermissionRequestEventSchema>;
+export type SessionAnswerEvent = z.infer<typeof SessionAnswerEventSchema>;
+export type PermissionAction = z.infer<typeof PermissionActionSchema>;
+export type SessionPermissionResolvedEvent = z.infer<typeof SessionPermissionResolvedEventSchema>;
+/** Params for answering a free-text question. */
+export declare const AnswerQuestionParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    text: string;
+    sessionId: string;
+}, {
+    requestId: string;
+    text: string;
+    sessionId: string;
+}>;
+/** Permission mode for Claude sessions. */
+export declare const PermissionModeSchema: z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan", "read-only", "safe-yolo", "yolo"]>;
+export type PermissionModeValue = z.infer<typeof PermissionModeSchema>;
+/** Params for approving a tool permission request. */
+export declare const ApprovePermissionParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    toolCallId: z.ZodString;
+    /** Optional mode change (e.g. 'acceptEdits' for "allow all edits this session"). */
+    mode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan", "read-only", "safe-yolo", "yolo"]>>;
+    /** Optional tool whitelist (e.g. ['Bash(npm test)'] for "don't ask again for this tool"). */
+    allowTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    toolCallId: string;
+    sessionId: string;
+    mode?: "default" | "acceptEdits" | "plan" | "bypassPermissions" | "read-only" | "safe-yolo" | "yolo" | undefined;
+    allowTools?: string[] | undefined;
+}, {
+    requestId: string;
+    toolCallId: string;
+    sessionId: string;
+    mode?: "default" | "acceptEdits" | "plan" | "bypassPermissions" | "read-only" | "safe-yolo" | "yolo" | undefined;
+    allowTools?: string[] | undefined;
+}>;
+/** Params for denying a tool permission request. */
+export declare const DenyPermissionParamsSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    toolCallId: z.ZodString;
+    /** Optional feedback from user explaining why permission was denied. */
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    requestId: string;
+    toolCallId: string;
+    sessionId: string;
+    reason?: string | undefined;
+}, {
+    requestId: string;
+    toolCallId: string;
+    sessionId: string;
+    reason?: string | undefined;
+}>;
+export type AnswerQuestionParams = z.infer<typeof AnswerQuestionParamsSchema>;
+export type ApprovePermissionParams = z.infer<typeof ApprovePermissionParamsSchema>;
+export type DenyPermissionParams = z.infer<typeof DenyPermissionParamsSchema>;
+//# sourceMappingURL=interactionEvents.d.ts.map

package/dist/interactionEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionEvents.d.ts","sourceRoot":"","sources":["../src/interactionEvents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,yDAAyD;AACzD,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,sCAAsC;AACtC,eAAO,MAAM,0BAA0B;;;;;IAOrC,qDAAqD;;IAErD,0DAA0D;;;;;;;;;;;IAE1D,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;EAEhD,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;EAO9C,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,qEAKjC,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,oCAAoC;;;;;;;;;;;;EAI/C,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAChG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAIlG,iDAAiD;AACjD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,sGAQ/B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,sDAAsD;AACtD,eAAO,MAAM,6BAA6B;;;;IAIxC,oFAAoF;;IAEpF,6FAA6F;;;;;;;;;;;;;;EAE7F,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,0BAA0B;;;;IAIrC,wEAAwE;;;;;;;;;;;;EAExE,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/interactionEvents.js

@@ -0,0 +1,92 @@
+/**
+ * Interaction event schemas for bidirectional communication.
+ *
+ * Event types: question, permission-request, answer.
+ * RPC params: answer-question, approve-permission, deny-permission.
+ */
+import { z } from 'zod';
+// ── Session Events ──
+/** Option for structured (multiple-choice) questions. */
+export const QuestionOptionSchema = z.object({
+    label: z.string(),
+    description: z.string().default(''),
+});
+/** Agent asks the user a question. */
+export const SessionQuestionEventSchema = z.object({
+    t: z.literal('question'),
+    requestId: z.string(),
+    text: z.string(),
+    questionType: z
+        .enum(['free-text', 'yes-no', 'single-select', 'multi-select'])
+        .default('free-text'),
+    /** Header/category chip for structured questions. */
+    header: z.string().optional(),
+    /** Options for single-select / multi-select questions. */
+    options: z.array(QuestionOptionSchema).optional(),
+    /** Whether multiple options can be selected. */
+    multiSelect: z.boolean().optional(),
+});
+/** Agent requests tool execution approval. */
+export const SessionPermissionRequestEventSchema = z.object({
+    t: z.literal('permission-request'),
+    requestId: z.string(),
+    toolName: z.string(),
+    toolCallId: z.string(),
+    args: z.record(z.unknown()),
+    description: z.string().default(''),
+});
+/** User's answer to a question or acknowledgement. */
+export const SessionAnswerEventSchema = z.object({
+    t: z.literal('answer'),
+    requestId: z.string(),
+    text: z.string(),
+});
+/** How a permission was resolved — persisted in envelope stream for history replay. */
+export const PermissionActionSchema = z.enum([
+    'approve',
+    'approve-all-edits',
+    'approve-tool',
+    'deny',
+]);
+/** Records the user's decision on a permission request (sent immediately after resolution). */
+export const SessionPermissionResolvedEventSchema = z.object({
+    t: z.literal('permission-resolved'),
+    requestId: z.string(),
+    action: PermissionActionSchema,
+});
+// ── RPC Params ──
+/** Params for answering a free-text question. */
+export const AnswerQuestionParamsSchema = z.object({
+    sessionId: z.string(),
+    requestId: z.string(),
+    text: z.string(),
+});
+/** Permission mode for Claude sessions. */
+export const PermissionModeSchema = z.enum([
+    'default',
+    'acceptEdits',
+    'bypassPermissions',
+    'plan',
+    'read-only',
+    'safe-yolo',
+    'yolo',
+]);
+/** Params for approving a tool permission request. */
+export const ApprovePermissionParamsSchema = z.object({
+    sessionId: z.string(),
+    requestId: z.string(),
+    toolCallId: z.string(),
+    /** Optional mode change (e.g. 'acceptEdits' for "allow all edits this session"). */
+    mode: PermissionModeSchema.optional(),
+    /** Optional tool whitelist (e.g. ['Bash(npm test)'] for "don't ask again for this tool"). */
+    allowTools: z.array(z.string()).optional(),
+});
+/** Params for denying a tool permission request. */
+export const DenyPermissionParamsSchema = z.object({
+    sessionId: z.string(),
+    requestId: z.string(),
+    toolCallId: z.string(),
+    /** Optional feedback from user explaining why permission was denied. */
+    reason: z.string().optional(),
+});
+//# sourceMappingURL=interactionEvents.js.map

package/dist/interactionEvents.js.map

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