@codmir/ai-instructions

@codmir/ai-instructions

Centralized AI instructions, prompts, and Gibber Link mode for AI-to-AI communication.

Features

• Centralized Instructions: Reusable AI instructions with priority and conditional application
• English Enforcement: Critical instruction to prevent language drift
• Duo Mode: AI-to-AI collaboration instructions
• Gibber Link: Audio-based data transmission for AI-to-AI communication (using ggwave)
• Prompt Builder: Context-aware system prompt generation

Installation

pnpm add @codmir/ai-instructions

For Gibber Link audio features, include ggwave in your HTML:

<script src="https://unpkg.com/ggwave@0.4.0/build/ggwave.js"></script>

Usage

Basic Prompt Building

import { buildPrompt, buildVoicePrompt, getEnglishEnforcement } from '@codmir/ai-instructions'

// Build a prompt with all applicable instructions
const result = buildPrompt('You are a helpful assistant.', {
  mode: 'voice',
  participantCount: 2,
  isAIToAI: false,
})

console.log(result.systemPrompt)
// Includes: English enforcement, human communication rules, voice style, etc.

Duo Mode (AI-to-AI)

import { buildDuoModePrompt } from '@codmir/ai-instructions'

const result = buildDuoModePrompt('You are an AI assistant collaborating with another AI.')
// Includes duo mode collaboration instructions

Gibber Link Mode

Gibber Link enables AI-to-AI communication via audio-encoded data transmission.

import { createGibberLink } from '@codmir/ai-instructions/gibberlink'

const gibberLink = createGibberLink({
  protocol: 'audible_fast',
  autoDetect: true,
})

// Start listening for messages
await gibberLink.startListening()

// Register message handler
gibberLink.onMessage((message) => {
  console.log('Received:', message.data)
})

// Send a message (encoded as audio)
await gibberLink.sendMessage('Hello from AI-1')

React Hooks

import { useGibberLink, useAIInstructions, useDuoModeDetection } from '@codmir/ai-instructions/react'

function VoiceRoom() {
  // Gibber Link for AI-to-AI audio communication
  const { isReady, startListening, sendMessage } = useGibberLink({
    onMessage: (msg) => console.log('Received:', msg.data),
  })

  // Build prompts with context
  const { buildForVoice, buildForDuoMode } = useAIInstructions()

  // Detect when AIs are talking to each other
  const { state, trackMessage } = useDuoModeDetection({
    aiParticipantIds: ['ai-1', 'ai-2'],
    gibberLinkThreshold: 3,
    onDuoModeDetected: (state) => {
      if (state.shouldSuggestGibberLink) {
        // Show UI to enable gibber link
      }
    },
  })

  return (
    <div>
      {state.isDuoMode && <p>Duo mode active: {state.activeAICount} AIs</p>}
      {state.shouldSuggestGibberLink && (
        <button onClick={startListening}>Enable Gibber Link</button>
      )}
    </div>
  )
}

Core Instructions

ID	Category	Priority	Description
english-enforcement	language	critical	Forces English-only responses
human-communication	communication	high	Natural human speech rules
voice-conversation	communication	high	Voice conversation style
duo-mode-base	duo_mode	high	AI-to-AI collaboration
duo-mode-tasks	duo_mode	medium	Task collaboration
voice-progress	communication	medium	Voice progress reporting
gibber-link-mode	communication	high	Audio-encoded communication
safety-guidelines	safety	critical	Safety boundaries

Gibber Link Protocol

Gibber Link uses ggwave for audio-based data transmission:

Protocol	Speed	Audibility
audible_fastest	Fastest	Most audible
audible_fast	Fast	Audible
audible_normal	Normal	Audible
ultrasound	Normal	Inaudible to humans

API Reference

buildPrompt(basePrompt, context)

Build a system prompt with applicable instructions.

buildDuoModePrompt(basePrompt, context)

Build a prompt for AI-to-AI collaboration.

buildGibberLinkPrompt(basePrompt, context)

Build a prompt for Gibber Link mode.

createGibberLink(config)

Create a GibberLink service for audio-based communication.

useGibberLink(options)

React hook for Gibber Link.

useDuoModeDetection(options)

React hook to detect AI-to-AI communication patterns.

Environment Variables

# Enable gibber link mode globally
AI_LINK_MODE_ENABLED=true

# Allow users to toggle
AI_LINK_MODE_USER_CONTROL=true

License

MIT