@j-o-r/hello-dave 0.1.0 → 0.1.4

package/types/AgentClient.d.ts

@@ -1,109 +0,0 @@
-export default AgentClient;
-export type OARequest = typeof import("./API/openai.com/reponses/text.js").request;
-export type XRequest = typeof import("./API/x.ai/text.js").request;
-export type ANTHRequest = typeof import("./API/anthropic.com/text.js").request;
-export type XOptions = import("./API/x.ai/text.js").XOptions;
-export type OAOptions = import("./API/openai.com/reponses/text.js").OAOptions;
-export type ANTHOptions = import("./API/anthropic.com/text.js").ANTHOptions;
-export type Prompt = import("./Prompt.js").default;
-export type ToolSet = import("./ToolSet.js").default;
-export type WSOptions = {
-    /**
-     * - The prompt session instance.
-     */
-    prompt: Prompt;
-    /**
-     * - Optional toolset for the prompt.
-     */
-    toolset?: import("./ToolSet.js").default | undefined;
-    /**
-     * - Custom introduction message for the agent.
-     */
-    description: string;
-    /**
-     * - Logical name (e.g., 'search', 'code', 'os').
-     */
-    name: string;
-    /**
-     * - Websocket server access secret (must match server).
-     */
-    secret: string;
-    /**
-     * - WebSocket URL.
-     */
-    url?: string | undefined;
-    /**
-     * - Polling interval for queue processing (ms).
-     */
-    intervalMs?: number | undefined;
-};
-/**
- * @module lib/AgentClient
- * @exports default AgentClient
- * Websocket client for AI agent sessions, wrapping a Prompt/ToolSet instance with robust queue-based message handling, auto-reconnect, and epoch-based resets.
- */
-/**
- * @typedef {import('./API/openai.com/reponses/text.js').request} OARequest
- * @typedef {import('./API/x.ai/text.js').request} XRequest
- * @typedef {import('./API/anthropic.com/text.js').request} ANTHRequest
- *
- * @typedef {import('./API/x.ai/text.js').XOptions} XOptions
- * @typedef {import('./API/openai.com/reponses/text.js').OAOptions} OAOptions
- * @typedef {import('./API/anthropic.com/text.js').ANTHOptions} ANTHOptions
- *
- * @typedef {import('./Prompt.js').default} Prompt
- * @typedef {import('./ToolSet.js').default} ToolSet
- */
-/**
- * @typedef {Object} WSOptions
- * @property {Prompt} prompt - The prompt session instance.
- * @property {ToolSet} [toolset] - Optional toolset for the prompt.
- * @property {string} description - Custom introduction message for the agent.
- * @property {string} name - Logical name (e.g., 'search', 'code', 'os').
- * @property {string} secret - Websocket server access secret (must match server).
- * @property {string} [url='ws://127.0.0.1:8000/ws'] - WebSocket URL.
- * @property {number} [intervalMs=2000] - Polling interval for queue processing (ms).
- * @example { prompt, name: 'code-agent', secret: 'abc123', url: 'ws://localhost:8001/ws' }
- */
-/**
- * AgentClient: WebSocket client wrapper for AI agent sessions.
- * Combines Prompt/ToolSet with WS communication for bidirectional queries, responses, tool calls, and resets.
- * Features: Sequential message queue (one-at-a-time processing), auto-reconnect on close, epoch invalidation for resets.
- * Logs events via console; emits via underlying Prompt (tool_request, tool_error, etc.).
- * @emits tool_request - When tools are requested (via #prompt).
- * @emits tool_error - When tools fail (via #prompt).
- * @example
- * const client = new AgentClient({
- *   prompt: myPrompt,
- *   name: 'code',
- *   description: 'Code execution agent',
- *   secret: 'mysecret',
- *   intervalMs: 1000
- * });
- */
-declare class AgentClient {
-    /**
-     * Initializes the AgentClient with configuration options.
-     * Registers Prompt events for logging and starts the WebSocket connection.
-     * @param {WSOptions} options - Configuration object.
-     * @throws {TypeError} If required options (e.g., prompt, secret) are invalid/missing.
-     * @example See WSOptions.
-     */
-    constructor(options: WSOptions);
-    /**
-     * @private
-     * Starts the WebSocket connection, sends introduction, sets up handlers.
-     * Auto-retries on close after 5s.
-     * @returns {void}
-     */
-    private _start;
-    /**
-     * Enqueues an incoming WebSocket message and starts interval processing if needed.
-     * Immediately handles 'reset' actions (clears queue, resets prompt, increments epoch).
-     * @param {MessageEvent} e - Raw WebSocket message event.
-     * @returns {void}
-     * @throws {SyntaxError} If JSON parse fails.
-     */
-    incoming(e: MessageEvent): void;
-    #private;
-}

package/types/AgentManager.d.ts

@@ -1,100 +0,0 @@
-export default AgentManager;
-export type XOptions = import("./API/x.ai/text.js").XOptions;
-export type XAIOptions = import("./API/x.ai/responses.js").XAIOptions;
-export type OAOptions = import("./API/openai.com/reponses/text.js").OAOptions;
-export type ANTHOptions = import("./API/anthropic.com/text.js").ANTHOptions;
-export type Setup = {
-    /**
-     * - Initial system prompt.
-     */
-    prompt: string;
-    /**
-     * - API model options.
-     */
-    options: XAIOptions | OAOptions | XOptions | ANTHOptions;
-    /**
-     * - AI provider.
-     */
-    api: "gpt" | "xai" | "claude";
-    /**
-     * - Token limit for context.
-     */
-    contextWindow?: number | undefined;
-    /**
-     * - Toolset activation mode.
-     */
-    toolsetMode?: "auto" | "required" | null | undefined;
-    /**
-     * - Enable verbose output.
-     */
-    debug?: boolean | undefined;
-};
-export type Options = {
-    /**
-     * - Agent name (validated /^[a-z_0-9]{2,}$/).
-     */
-    name: string;
-    /**
-     * - WS auth secret (base64-encoded).
-     */
-    secret: string;
-    /**
-     * - Session cache directory.
-     */
-    cachePath?: string | undefined;
-};
-declare class AgentManager {
-    /**
-     * Initializes AgentManager with base options.
-     * Validates name regex; encodes secret.
-     * @param {Options} options - Base configuration.
-     * @throws {Error} Invalid name (regex) or options.
-     * @chainable
-     */
-    constructor(options: Options);
-    /**
-     * Configures the Prompt/Session/ToolSet with API adaptor.
-     * Adds system prompt; chains to start().
-     * @param {Setup} setup - AI setup details.
-     * @returns {AgentManager} This instance (chainable).
-     * @throws {Error} Invalid setup.
-     * @example mgr.setup({ prompt: 'You are a coder...', api: 'gpt', options: { model: 'gpt-4o' } });
-     */
-    setup(setup: Setup): AgentManager;
-    /**
-     * Direct synchronous call to the underlying Prompt.
-     * @param {string} input - User input.
-     * @returns {Promise<string>} Response.
-     * @throws {Error} No setup.
-     */
-    directCall(input: string): Promise<any> & lt;
-    /** @returns {Prompt} Underlying Prompt instance. */
-    getPrompt(): Prompt;
-    /** @returns {ToolSet|null} Toolset if configured. */
-    getToolset(): ToolSet | null;
-    /** @returns {Promise&lt;import('./fafs.js').EnvironmentInfo&gt;} System env info. */
-    environment(): Promise<any> & lt;
-    /**
-     * Adds a pre-defined generic tool from toolsPool (genericToolset) to this agent's ToolSet.
-     * @param {'execute_bash_script'|'execute_remote_script'|'get_user_env'|'history_search'|'javascript_interpreter'|'memory_recall'|'memory_write'|'open_link'|'read_file'|'send_email'|'syntax_check'|'write_file'} name - Tool name.
-     * @throws {Error} Invalid name, no toolset, or tool missing.
-     * @example mgr.addGenericToolcall('read_file');
-     */
-    addGenericToolcall(name: "execute_bash_script" | "execute_remote_script" | "get_user_env" | "history_search" | "javascript_interpreter" | "memory_recall" | "memory_write" | "open_link" | "read_file" | "send_email" | "syntax_check" | "write_file"): void;
-    /**
-     * Smart launcher: CLI (default), server (servePort), or client (connectUrl).
-     * Auto-generates intros/descriptions if empty.
-     * @param {number} [servePort] - Launch server on port.
-     * @param {string} [connectUrl] - Connect as client to WS.
-     * @param {string} [cliIntro=""] - CLI intro text.
-     * @param {string} [toolName=""] - Tool/server name (falls back to #name).
-     * @param {string} [toolDescription=""] - Tool desc.
-     * @returns {Promise&lt;void&gt;}
-     * @throws {Error} No setup; invalid names/ports.
-     * @example mgr.start(8000); // Server\nmgr.start(undefined, 'ws://other:8001/ws'); // Client\nmgr.start(); // CLI
-     */
-    start(servePort?: number, connectUrl?: string, cliIntro?: string, toolName?: string, toolDescription?: string): Promise<any> & lt;
-    #private;
-}
-import { Prompt } from './index.js';
-import { ToolSet } from './index.js';

package/types/AgentServer.d.ts

@@ -1,89 +0,0 @@
-export default AgentServer;
-export type Client = import("@j-o-r/apiserver/types/ClientWrapper.d.ts").ClientWrapper;
-export type Prompt = import("./Prompt.js").default;
-export type ToolSet = import("./ToolSet.js").default;
-export type Session = import("./Session.js").default;
-export type MessageContent = string | object;
-export type Message = {
-    /**
-     * - Action type (must be in ACTIONS).
-     */
-    action: string;
-    content?: MessageContent | undefined;
-    id?: string | undefined;
-};
-export type AgentServerOptions = {
-    /**
-     * - Server/agent name.
-     */
-    name: string;
-    /**
-     * - Access secret (matches client secrets).
-     */
-    secret: string;
-    /**
-     * - Server description.
-     */
-    description: string;
-    /**
-     * - Prompt instance.
-     */
-    prompt: Prompt;
-    /**
-     * - Session manager.
-     */
-    session: Session;
-    /**
-     * - Custom auth function.
-     */
-    auth?: AuthFunction;
-    /**
-     * - Listen port (>=1024).
-     */
-    port?: number | undefined;
-    /**
-     * - Verbose logging.
-     */
-    debug?: boolean | undefined;
-};
-/**
- * AgentServer: Core WebSocket server class.
- * Exposes connected agents as tools; handles user CLI/WS interactions, auth, sessions.
- * Starts on localhost; broadcasts resets.
- * Logs events via console; emits via Prompt.
- * @emits tool_request - Tool calls (via #prompt).
- * @emits tool_error - Tool failures (via #prompt).
- * @example
- * const server = new AgentServer({
- *   name: 'main',
- *   prompt: myPrompt,
- *   session: mySession,
- *   secret: 'abc',
- *   port: 8000,
- *   debug: true
- * });
- */
-declare class AgentServer {
-    /**
-     * Initializes and starts the AgentServer.
-     * Validates port, sets up Prompt event logging, launches WS server.
-     * @param {AgentServerOptions} options - Server configuration.
-     * @throws {Error} If port < 1024.
-     * @example See AgentServerOptions.
-     */
-    constructor(options: AgentServerOptions);
-    /**
-     * @private
-     * Launches the WS server with handlers for messages, connections, closes.
-     * Defines HTTP / API index endpoint.
-     * @returns {Promise<void>}
-     */
-    private _start;
-    /**
-     * Broadcasts a reset message to all connected clients (starts new sessions).
-     * @returns {void}
-     * @fires reset - Via underlying prompt/clients.
-     */
-    resetAll(): void;
-    #private;
-}

package/types/wsCli.d.ts

@@ -1,17 +0,0 @@
-#!/usr/bin/env -S node
-declare function _default(connectUrl: string, secret?: string): void;
-export default _default;
-export type WsMessage = {
-    /**
-     * - Action type (e.g., 'user_request')
-     */
-    action: string;
-    /**
-     * - Message content
-     */
-    content: string;
-    /**
-     * - Unique message ID
-     */
-    id: number;
-};

package/types/wsIO.d.ts

@@ -1,30 +0,0 @@
-/**
-* @typedef {object} wsResponse
-* @property {string} action
-* @property {string} content
-* @property {number} id - message id
-*/
-/**
-* One-shot WebSocket client for hello-dave server using standard 'ws' library.
-* Connects directly to pure WS endpoint (no HTTP upgrade).
-* Sends intro + action, awaits matching response by ID, closes, returns response.
-*
-* @param {string} connectUrl - Websocket server endpoint to connect to
-* @param {string} [secret=''] - Secret websocket connection key
-* @param {'user_request'|'user_info'|'user_reset'} action - Action to perform
-* @param {string} [input=''] - Input content (required for 'user_request')
-* @returns {Promise<wsResponse>}
-* @throws {Error} Invalid action or missing input for user_request
-* @example
-* const response = await wsio('ws://localhost:8080', 'secret', 'user_request', 'Hello!');
-* console.log(response.content);
-*/
-export default function wsio(connectUrl: string, secret?: string, action: "user_request" | "user_info" | "user_reset", input?: string): Promise<any> & lt;
-export type wsResponse = {
-    action: string;
-    content: string;
-    /**
-     * - message id
-     */
-    id: number;
-};

package/utils/test.sh

@@ -1,46 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-TEST_DIR="${1:-scenarios}"
-echo "=== TestDave: Running all tests in $TEST_DIR/ ==="
-
-shopt -s nullglob
-TEST_FILES=("$TEST_DIR"/*.test.js)
-
-if [ ${#TEST_FILES[@]} -eq 0 ]; then
-  echo "No *.test.js files found in $TEST_DIR/"
-  exit 0
-fi
-
-echo "Found ${#TEST_FILES[@]} test files."
-
-TOTAL=${#TEST_FILES[@]}
-PASSED=0
-FAILED=()
-
-for test_file in "${TEST_FILES[@]}"; do
-  echo ""
-  echo "=== $test_file ==="
-  RC=$(timeout 60s "$test_file");
-  XT=$?
-  echo "$RC";
-  if [ "$XT" -eq 0 ]; then
-     echo "✅ PASS"
-     ((PASSED = PASSED + 1))
-  else
-     echo "❌ FAIL (exit code $XT)"
-     FAILED+=("$test_file")
-  fi
-done
-
-echo ""
-echo "=== SUMMARY ==="
-echo "Total: $TOTAL"
-echo "Passed: $PASSED"
-echo "Failed: ${#FAILED[@]}"
-if [ ${#FAILED[@]} -gt 0 ]; then
-  echo "Failed tests:"
-  for f in "${FAILED[@]}"; do echo "  $f"; done
-  exit 1
-fi
-echo "🎉 All tests passed!"