@tencent-ai/agent-harness 0.2.0-beta.7 → 0.2.0-beta.8

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/mods/types/events/command.d.ts

@@ -0,0 +1,114 @@
+/**
+ * `types/events/command.ts`
+ *
+ * Precise `command.*` event shapes: `command.run`, `command.describe`, plus
+ * op-facing types `CommandInfo` / `CommandSpec` / `CommandPresentation` /
+ * `CommandSource`.
+ */
+import type { Origin } from '../events.js';
+import type { PromptOrigin } from './prompt.js';
+/**
+ * Where a slash command comes from, as `$.command.list()` tells them apart.
+ */
+export type CommandSource = 'builtin' | 'plugin' | 'user' | 'mcp';
+/**
+ * Where a command's answer will show: which of the terminal's two layouts
+ * the surface renders, and how wide it is when the command runs.
+ */
+export interface CommandPresentation {
+    /** True under the fullscreen (alternate-screen) layout. */
+    isFullscreen: boolean;
+    /** The terminal's width in cells as the command runs; 80 where headless. */
+    columns: number;
+}
+/**
+ * The input of `command.run`: one slash command about to run, the way the
+ * person typed it (`/name args`), and where the run came from.
+ */
+export interface CommandRunInput {
+    /** Names the command without its slash. Pinned: rewrite refused. */
+    command: string;
+    /** Everything after the name, as typed (`""` when nothing). */
+    args: string;
+    /** Where the run came from. */
+    origin: PromptOrigin;
+    /** Where the command's answer will show. Pinned. */
+    presentation: CommandPresentation;
+}
+/**
+ * `command.run`'s input as a plugin's `$.command.run` takes it: `args` may
+ * be left out (`/command`, bare); `origin` and `presentation` the engine sets.
+ */
+export type CommandRunArgs = Omit<CommandRunInput, 'origin' | 'args' | 'presentation'> & {
+    /** Everything after the name; left out, `""`. */
+    args?: string;
+};
+/**
+ * What a `command.run` hook returns: the command's output text and the notes
+ * it leaves the model.
+ */
+export interface CommandRunResult {
+    /** The command's output as a transcript line, or undefined for silent commands. */
+    text?: string;
+    /** What the model reads after the command's output. */
+    context?: readonly string[];
+    /** Set by core on what `next(e)` resolves to. */
+    ref?: number;
+}
+/**
+ * The input of `command.describe`: how one slash command's menu row presents.
+ */
+export interface CommandDescribeInput {
+    /** Names the command without its slash. Pinned. */
+    command: string;
+    /** The one-line description the menu shows. */
+    description: string;
+    /** The hint drawn dim after the name (`[name]`). */
+    argumentHint?: string;
+    /** Whether the typeahead and `/help` leave the command out. */
+    isHidden: boolean;
+    /**
+     * Whether the command declares it runs at once when typed mid-turn.
+     * Pinned: a rewrite is refused.
+     */
+    immediate: boolean;
+    /** Who provides this command. Pinned: a rewrite is refused. */
+    provider: Origin;
+}
+/**
+ * What a `command.describe` hook returns: the description, hint and hidden
+ * flag the menu uses; the name, `immediate` and `provider` stay as they were.
+ */
+export type CommandDescribeResult = Omit<CommandDescribeInput, 'command' | 'immediate' | 'provider'>;
+/**
+ * One slash command as `$.command.list()` returns it.
+ */
+export interface CommandInfo {
+    /** What the person runs it by, without the slash. */
+    name: string;
+    /** The one line the typeahead shows for it. */
+    description: string;
+    /** Where it comes from. */
+    source: CommandSource;
+    /** Which plugin added it, when `source` is `plugin` and the engine knows. */
+    plugin?: string;
+}
+/**
+ * What `$.command.register` takes: the slash command this plugin serves.
+ */
+export interface CommandSpec {
+    /** The command's name without the slash. */
+    name: string;
+    /** The one line the typeahead and `/help` show for it. */
+    description: string;
+    /** The hint drawn dim after the name (`[name]`). */
+    argumentHint?: string;
+    /** Set so that `/<name>` typed while a turn is in flight runs at once. */
+    immediate?: true;
+}
+/**
+ * What `$.command.register` resolves to: the registered name.
+ */
+export interface CommandRegisterResult {
+    command: string;
+}

package/cli/dist-server/types/workspace/cbc-plugins/lib/node/mods/types/events/prompt.d.ts

@@ -0,0 +1,310 @@
+/**
+ * `types/events/prompt.ts`
+ *
+ * Precise `prompt.*` event shapes: `prompt.submit`, `prompt.fill`,
+ * `prompt.suggest`, `prompt.edit`, `prompt.section`, `prompt.context`,
+ * `prompt.attachment`, plus supporting `PromptOrigin` / `PromptBox` /
+ * `PromptContextBlock` / `InstructionFile`.
+ */
+type ClientKeyEvent = Readonly<{
+    key: string;
+    text?: string;
+    shift?: true;
+    alt?: true;
+    ctrl?: true;
+    [k: string]: unknown;
+}>;
+/**
+ * What tier an instruction file belongs to.
+ */
+export type InstructionFileKind = 'managed' | 'user' | 'project' | 'local' | 'memory';
+/**
+ * One instruction file behind the `claudeMd` block.
+ */
+export interface InstructionFile {
+    /** The file's path, absolute. */
+    path: string;
+    /** Its tier. */
+    kind: InstructionFileKind;
+    /** The text as loaded (comments and frontmatter stripped). */
+    content: string;
+    /** The path of the file whose `@` import brought this one. */
+    parent?: string;
+}
+/**
+ * Where a `prompt.submit` submission came from. Closed set, pinned on the
+ * event; a hooks module reads `e.origin.kind` to tell sources apart.
+ */
+export type PromptOrigin = {
+    kind: 'composer';
+} | {
+    kind: 'bridge';
+} | {
+    kind: 'sdk';
+} | {
+    kind: 'task-notification';
+} | {
+    kind: 'scheduled-trigger';
+} | {
+    kind: 'peer';
+} | {
+    kind: 'peer-send-message';
+} | {
+    kind: 'projects-relay';
+} | {
+    kind: 'channel';
+    server: string;
+} | {
+    kind: 'coordinator';
+} | {
+    kind: 'observer';
+} | {
+    kind: 'observer-activity';
+} | {
+    kind: 'auto-continuation';
+} | {
+    kind: 'unclassified';
+} | {
+    kind: 'slack-ping';
+} | {
+    kind: 'plugin';
+    name: string;
+};
+/**
+ * Who authored the text an injected attachment carries.
+ */
+export type PromptAttachmentOrigin = {
+    kind: 'engine';
+} | {
+    kind: 'hook';
+    event: string;
+} | {
+    kind: 'plugin';
+    event: string;
+};
+/**
+ * The input of `prompt.attachment`: one attachment at the moment the engine
+ * frames it for the model.
+ */
+export interface PromptAttachmentInput {
+    /** Kind name; a matcher narrows on this. */
+    type: string;
+    /** What the model reads for this attachment, inside the engine's framing. */
+    text: string;
+    /** Who authored the text. Pinned. */
+    origin: PromptAttachmentOrigin;
+    /** The loop whose request carries the attachment. Pinned. */
+    agentId?: string;
+}
+/**
+ * What a `prompt.attachment` hook returns: the text the model reads, or null.
+ */
+export interface PromptAttachmentResult {
+    text: string | null;
+}
+/**
+ * The person's prompt box as it stands: the draft and where the cursor is.
+ */
+export interface PromptBox {
+    /** The draft as typed so far; `''` where the session draws no box. */
+    text: string;
+    /** Cursor offset into `text` in UTF-16 code units. */
+    cursor: number;
+}
+/**
+ * One block of the context the first user message carries.
+ */
+export interface PromptContextBlock {
+    /** The key the block renders under (`claudeMd`, `userEmail`, ...). */
+    name: string;
+    /** The block's text. */
+    text: string;
+}
+/**
+ * The context blocks of a conversation's first user message.
+ */
+export interface PromptContextBlocks {
+    blocks: readonly PromptContextBlock[];
+}
+/**
+ * The input of `prompt.context`: the context blocks the engine prepends.
+ */
+export interface PromptContextInput {
+    blocks: readonly PromptContextBlock[];
+    /** The files behind `claudeMd`, in the order it renders them. */
+    instructionFiles?: readonly InstructionFile[];
+}
+/**
+ * What a `prompt.context` hook returns: the blocks the conversation carries.
+ */
+export interface PromptContextResult {
+    blocks: readonly PromptContextBlock[];
+    instructionFiles?: readonly InstructionFile[];
+}
+/**
+ * Who edits the prompt box at `prompt.edit`.
+ */
+export type PromptEditOrigin = {
+    kind: 'composer';
+};
+/**
+ * The input of `prompt.edit`: one edit the person makes in the prompt box.
+ */
+export interface PromptEditInput {
+    /** Who edits. Pinned. */
+    origin: PromptEditOrigin;
+    /** The one key that made the edit, when one did; absent for a paste. */
+    key?: ClientKeyEvent;
+    /** The draft before the edit. */
+    text: string;
+    /** Where the person's caret stood in `text` before the edit. */
+    cursor: number;
+    /** Where in `text` the edit begins. */
+    start: number;
+    /** Where the replaced span of `text` ends. */
+    end: number;
+    /** What goes in between `start` and `end`. */
+    inputText: string;
+}
+/**
+ * What a `prompt.edit` hook returns: the box after the edit.
+ */
+export type PromptEditResult = PromptBox;
+/**
+ * Where a `prompt.fill` puts its text: over the whole draft, after it, or
+ * into it at the cursor.
+ */
+export type PromptFillMode = 'replace' | 'append' | 'insert';
+/**
+ * Who writes the prompt box at `prompt.fill`.
+ */
+export type PromptFillOrigin = {
+    kind: 'engine';
+} | {
+    kind: 'plugin';
+    name: string;
+};
+/**
+ * The input of `prompt.fill`: a text about to be put in the prompt box.
+ */
+export interface PromptFillInput {
+    /** What the box takes. */
+    text: string;
+    /** Where the text goes. */
+    mode: PromptFillMode;
+    /** Who writes. Pinned. */
+    origin: PromptFillOrigin;
+}
+/**
+ * `$.prompt.fill(args)` — `origin` filled by engine, `mode` optional.
+ */
+export interface PromptFillArgs {
+    text: string;
+    mode?: PromptFillMode;
+}
+/**
+ * What a `prompt.fill` hook returns.
+ */
+export interface PromptFillResult {
+    isFilled: boolean;
+}
+/**
+ * What `$.prompt.fill` resolves to: whether the box took the text and the
+ * box afterwards.
+ */
+export interface PromptFilled {
+    isFilled: boolean;
+    text: string;
+    cursor: number;
+}
+/**
+ * The input of `prompt.section`: one named section of the system prompt.
+ */
+export interface PromptSectionInput {
+    /** As the engine names the section (`env_info_simple`, `memory`, ...). */
+    name: string;
+    /** The section's text as core computed it, or null when core omits it. */
+    text: string | null;
+}
+/**
+ * What a `prompt.section` hook returns.
+ */
+export interface PromptSectionResult {
+    text: string | null;
+}
+/**
+ * A pasted or attached non-text item of a submitted prompt.
+ */
+export interface PromptSubmitAttachment {
+    type: 'image' | 'audio' | 'document';
+    mediaType?: string;
+    filename?: string;
+}
+/**
+ * The input of `prompt.submit`: the prompt as typed.
+ */
+export interface PromptSubmitInput {
+    /** The prompt's text as it will reach the model. */
+    text: string;
+    /** Non-text items of the submission. */
+    attachments?: readonly PromptSubmitAttachment[];
+    /** What the model reads beside the prompt; each entry one block. */
+    context?: readonly string[];
+    /** The id of the model turn that was running when the prompt was submitted. */
+    turnId?: string;
+    /** Whether the user asked the prompt to wait its turn. */
+    wait: boolean;
+    /** Where the submission came from. */
+    origin: PromptOrigin;
+}
+/**
+ * `$.prompt.submit(args)`: `origin`, `turnId` and `wait` engine's to set.
+ */
+export type PromptSubmitArgs = Omit<PromptSubmitInput, 'origin' | 'turnId' | 'wait' | 'context'>;
+/**
+ * What a `prompt.submit` hook returns.
+ */
+export type PromptSubmitResult = {
+    /** The prompt that entered. */
+    text: string;
+    /** What entered beside the prompt for the model. */
+    context?: readonly string[];
+    /** Where the prompt entered from. */
+    origin?: PromptOrigin;
+    drop?: undefined;
+} | {
+    /** The prompt did not enter. */
+    drop: string;
+    text?: undefined;
+    context?: undefined;
+    origin?: undefined;
+};
+/**
+ * Who proposes the text at `prompt.suggest`.
+ */
+export type PromptSuggestOrigin = {
+    kind: 'suggestion';
+} | {
+    kind: 'plugin';
+    name: string;
+};
+/**
+ * The input of `prompt.suggest`: dim text about to be shown in the empty box.
+ */
+export interface PromptSuggestInput {
+    /** The proposed prompt: shown, not written. */
+    text: string;
+    /** Who proposes. Pinned. */
+    origin: PromptSuggestOrigin;
+}
+/**
+ * `$.prompt.suggest(args)`: `origin` engine's to set.
+ */
+export type PromptSuggestArgs = Omit<PromptSuggestInput, 'origin'>;
+/**
+ * What a `prompt.suggest` hook returns.
+ */
+export interface PromptSuggestResult {
+    isShown: boolean;
+}
+export {};